You are on page 1of 503

CICS® Transaction Server for OS/390 ®

IBM

CICS User’s Handbook
Release 3

SX33-6104-02

CICS® Transaction Server for OS/390 ®

IBM

CICS User’s Handbook
Release 3

SX33-6104-02

Note! Before using this information and the product it supports, be sure to read the 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, and modifications until otherwise indicated in new editions. Make sure you are using the 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 of changes" and are indicated by a vertical bar to the left of a change. Order publications through your IBM representative or the IBM branch office serving your locality. Publications are not stocked at the address given below. At the back of this publication is a page entitled “Sending your comments to IBM”. If you want to make comments, but the methods described are not available to you, please address them to: IBM United Kingdom Laboratories, Information Development, Mail Point 095, Hursley Park, Winchester, Hampshire, England, SO21 2JN. When you send information to IBM, you grant IBM a nonexclusive right to use or distribute the information in any way it believes appropriate without incurring any obligation to you. © Copyright International Business Machines Corporation 1989, 1999. All rights reserved. US Government Users Restricted Rights – Use, duplication or disclosure restricted by GSA ADP Schedule Contract with IBM Corp.

Contents
Notices . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . v Programming interface information . . . . . . . . . . . . . . . . . . . . vi Trademarks . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . vii Preface . . . . . . . . . . . . . . . . . What this handbook is about . . . . . . Who this handbook is for . . . . . . What you need to know to understand Handbook structure . . . . . . . . . . .
. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . this handbook . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .

ix ix ix ix x

Bibliography . . . . . . . . . . . . . . . . . . . . . . CICS Transaction Server for OS/390 . . . . . . . . . . CICS books for CICS Transaction Server for OS/390 CICSPlex SM books for CICS Transaction Server for Other CICS books . . . . . . . . . . . . . . . . . . Determining if a publication is current . . . . . . . . .

. . . . . . . . . . . . . . . . . OS/390 . . . . . . . . . . . . .

. xiii . xiii . xiii . xv . xv . xv

Summary of changes . . . . . . . . . . . . . . . . . . . . . . . . . . Changes made for CICS Transaction Server for OS/390 Release 3 Changes made for CICS Transaction Server for OS/390 Release 2 . Changes made for CICS/ESA 4.1 edition . . . . . . . . . . . . . . . Chapter 1. Command-level application programming . . General format . . . . . . . . . . . . . . . . . . . . . . . . Restrictions for distributed program link (DPL) . . . . . . . . API command syntax . . . . . . . . . . . . . . . . . . . . . Chapter 2. SPI command syntax
. . . . . . . . . . . . . . . . . . . . . . . .

xvii xvii xvii xvii 1 1 2 3

. . . . . . . . . . . . . . . . . . . 91 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .

Chapter 3. CICS-Supplied Transaction Chapter 4. Resource definition online Chapter 5. DFHCSDUP commands

167 197 205 211 211 218 225 225 233

. . . . . . . . . . . . . . . . .

Chapter 6. Front End Programming Interface command reference FEPI application programming . . . . . . . . . . . . . . . . . . . . . FEPI system programming . . . . . . . . . . . . . . . . . . . . . . . Chapter 7. CICS-value data areas used by all commands . . . . CVDAs and numeric values in alphabetic sequence . . . . . . . . . . CVDAs and numeric values in numeric sequence . . . . . . . . . . .
© Copyright IBM Corp. 1989, 1999

iii

CVDA values for the DEVICE option

. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .

240 243 243 244 249 254 257

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

. . . .

Chapter 9. RESP2 values and their meanings

. . . . . . . . . . .

Chapter 10. EXEC interface block (EIB) response codes . . . . . . . . . . . . . . . . . . . . . . . Response codes of EXEC CICS commands . . . . . . . . Function codes of EXEC CICS commands Chapter 11. DFH messages . . Message Identifiers . . . . . . . . Format of information . . . . . . . MVS user abend codes . . . . . .
. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .

and function
. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .

397 397 399 407 407 411 415 419 420 421 463 465 465 471 474 475 479 481

Chapter 12. Transaction abend codes . . . . . . . . . . . . . . . Format of information . . . . . . . . . . . . . . . . . . . . . . . . . . Chapter 13. Transaction abend codes
. . . . . . . . . . . . . . . . . . . . . . . . .

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

Chapter 15. VTAM-associated errors . . . . . . . . . . . . . . . . VTAM terminal error codes and CICS message numbers . . . . . . . Chapter 16. System sense codes received Action flag settings and default actions
. . . . . . . . . . . . . ˚˚˚˚˚ . . .

Chapter 17. VTAM submodule identifiers . . . . . . . . . . . . . . Chapter 18. AP domain storage classes Sending your comments to IBM
. . . . . . . . . . . . . .

. . . . . . . . . . . . . . . . . . .

iv

CICS User’s Handbook

Notices
This information was developed for products and services offered in the U.S.A. IBM may not offer the products, services, or features discussed in this document in other countries. Consult your local IBM representative for information on the products and services currently available in your area. Any reference to an IBM product, program, or service is not intended to state or imply that only that IBM product, program, or service may be used. Any functionally equivalent product, program, or service that does not infringe any IBM intellectual property right may be used instead. However, it is the user's responsibility to evaluate and verify the operation of any non-IBM product, program, or service. IBM may have patents or pending patent applications covering subject matter described in this document. The furnishing of this document does not give you any license to these patents. You can send license inquiries, in writing, to: IBM Director of Licensing IBM Corporation North Castle Drive Armonk, NY 10504-1785 U.S.A. For license inquiries regarding double-byte (DBCS) information, contact the IBM Intellectual Property Department in your country or send inquiries, in writing, to: IBM World Trade Asia Corporation Licensing 2-31 Roppongi 3-chome, Minato-ku Tokyo 106, Japan The following paragraph does not apply in the United Kingdom or any other country where such provisions are inconsistent with local law: INTERNATIONAL BUSINESS MACHINES CORPORATION PROVIDES THIS 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. Some states do not allow disclaimer of express or implied warranties in certain transactions, 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 make improvements 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 the purpose of enabling: (i) the exchange of information between independently created programs and other programs (including this one) and (ii) the mutual use of the information which has been exchanged, should contact IBM United Kingdom Laboratories, MP151, Hursley Park, Winchester, Hampshire, England, SO21 2JN. Such information may be available, subject to appropriate terms and conditions, including in some cases, payment of a fee. The licensed program described in this document and all licensed material available for it are provided by IBM under terms of the IBM Customer Agreement, IBM International Programming License Agreement, or any equivalent agreement between us.

Programming interface information
This book is intended to help you refer quickly to CICS system administration and operating information. This book also documents General-use Programming Interface and Associated Guidance Information, Product-sensitive Programming Interface and Associated Guidance Information, and Diagnosis, Modification or Tuning Information provided by CICS. General-use programming interfaces allow the customer to write programs that obtain the services of CICS. General-use Programming Interface and Associated Guidance Information is identified where it occurs, by an introductory statement to a chapter or section. Product-sensitive programming interfaces allow the customer installation to perform tasks such as diagnosing, modifying, monitoring, repairing, tailoring, or tuning of CICS. Use of such interfaces creates dependencies on the detailed design or implementation of the IBM software product. Product-sensitive programming interfaces should be used only for these specialized purposes. Because of their dependencies on detailed design and implementation, it is to be expected that programs written to such interfaces may need to be changed in order to run with new product releases or versions, or as a result of service.

vi

CICS User’s Handbook

Product-sensitive Programming Interface and Associated Guidance Information is identified where it occurs, by an introductory statement to a chapter or section. Diagnosis, Modification or Tuning Information is provided to help you diagnose problems in a CICS system. Attention: Do not use this Diagnosis, Modification or Tuning Information as a programming interface. Diagnosis, Modification or Tuning Information is identified where it occurs, by an introductory statement to a chapter or section.

Trademarks
The following terms are trademarks of International Business Machines Corporation in the United States, or other countries, or both:
ACF/VTAM CICS CICS OS/2 CICS/ESA CICS/MVS CICS/VSE C/370 DB2 IBM IBMLink MVS/ESA RACF VSE/ESA VTAM

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

Notices

vii

viii

CICS User’s Handbook

Preface

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

Who this handbook is for
This book is for: System programmers CICS or system operators Application programmers.

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

© Copyright IBM Corp. 1989, 1999

ix

Handbook structure
Chapter 1, “Command-level application programming” on page 1 Gives a summary of command-level application programming commands in CICS Transaction Server for OS/390. For programming information, see the CICS Application Programming Reference. Chapter 2, “SPI command syntax” on page 91 Gives a summary of command-level system programming commands. For programming information, see the CICS System Programming Reference manual. Chapter 3, “CICS-Supplied Transaction” on page 167 Gives a summary of the CICS-supplied transactions. For more detailed information, see the CICS Supplied Transactions. Chapter 4, “Resource definition online” on page 197 Gives a summary of the syntax for resource definition online. For more detailed information, see the CICS Resource Definition Guide. Chapter 6, “Front End Programming Interface command reference” on page 211 Gives a summary of the syntax for front end programming interface command references. For more detailed information, see the CICS Front End Programming Interface User's Guide. Chapter 7, “CICS-value data areas used by all commands” on page 225 Gives a table of CVDA values. For programming information, see the CICS System 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, see the 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 detailed information, see the CICS System Programming Reference and the CICS Problem Determination Guide. Chapter 11, “DFH messages” on page 407 Gives a summary of the terminal error messages and codes. For more detailed 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 detailed information, 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 more detailed 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

xii

CICS User’s Handbook

Bibliography

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

CICS books for CICS Transaction Server for OS/390

© Copyright IBM Corp. 1989, 1999

xiii

General CICS Master Index CICS User's Handbook CICS Transaction Server for OS/390 Glossary (softcopy only) Administration CICS System Definition Guide CICS Customization Guide CICS Resource Definition Guide CICS Operations and Utilities Guide CICS Supplied Transactions Programming CICS Application Programming Guide CICS Application Programming Reference CICS System Programming Reference CICS Front End Programming Interface User's Guide CICS C++ OO Class Libraries CICS Distributed Transaction Programming Guide CICS Business Transaction Services Diagnosis CICS Problem Determination Guide CICS Messages and Codes CICS Diagnosis Reference CICS Data Areas CICS Trace Entries CICS Supplementary Data Areas Communication CICS Intercommunication Guide CICS Family: Interproduct Communication CICS Family: Communicating from CICS on System/390 CICS External Interfaces Guide CICS Internet Guide Special topics CICS Recovery and Restart Guide CICS Performance Guide CICS IMS Database Control Guide CICS RACF Security Guide CICS Shared Data Tables Guide CICS Transaction Affinities Utility Guide CICS DB2 Guide

SC33-1704 SX33-6104 GC33-1705 SC33-1682 SC33-1683 SC33-1684 SC33-1685 SC33-1686 SC33-1687 SC33-1688 SC33-1689 SC33-1692 SC34-5455 SC33-1691 SC34-5268 GC33-1693 GC33-1694 LY33-6088 LY33-6089 SC34-5446 LY33-6090 SC33-1695 SC33-0824 SC33-1697 SC33-1944 SC34-5445 SC33-1698 SC33-1699 SC33-1700 SC33-1701 SC33-1702 SC33-1777 SC33-1939

xiv

CICS User’s Handbook

CICSPlex SM books for CICS Transaction Server for OS/390
General CICSPlex SM Master Index CICSPlex SM Concepts and Planning CICSPlex SM User Interface Guide CICSPlex SM View Commands Reference Summary Administration and Management CICSPlex SM Administration CICSPlex SM Operations Views Reference CICSPlex SM Monitor Views Reference CICSPlex SM Managing Workloads CICSPlex SM Managing Resource Usage CICSPlex SM Managing Business Applications Programming CICSPlex SM Application Programming Guide CICSPlex SM Application Programming Reference Diagnosis CICSPlex SM Resource Tables Reference CICSPlex SM Messages and Codes CICSPlex SM Problem Determination SC33-1812 GC33-0786 SC33-0788 SX33-6099 SC34-5401 SC33-0789 SC34-5402 SC33-1807 SC33-1808 SC33-1809 SC34-5457 SC34-5458 SC33-1220 GC33-0790 GC33-0791

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

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

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

Bibliography

xv

Subsequent updates will probably be available in softcopy before they are available in hardcopy. This means that at any time from the availability of a release, softcopy versions should be regarded as the most up-to-date. For CICS Transaction Server books, these softcopy updates appear regularly on the Transaction Processing and Data Collection Kit CD-ROM, SK2T-0730-xx. Each reissue of the collection kit is indicated by an updated order number suffix (the -xx part). For example, collection kit SK2T-0730-06 is more up-to-date than SK2T-0730-05. The collection kit is also clearly dated on the cover. Updates to the softcopy are clearly marked by revision codes (usually a “#” character) to the left of the changes.

xvi

CICS User’s Handbook

''

Summary of changes

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

Changes made for CICS Transaction Server for OS/390 Release 2
This handbook includes information about the new or enhanced facilities introduced 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 edition
The commands for application programming and system programming are shown in alphabetic order. In the section Chapter 7, “CICS-value data areas used by all commands” on page 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 Application Programming Reference manual. Trace has been removed from this handbook and has been moved into the CICS Diagnosis Reference manual. Front end programming interface (FEPI) commands have been added.

© Copyright IBM Corp. 1989, 1999

xvii

''

xviii

CICS User’s Handbook

Application Programming

Chapter 1. Command-level application programming
This chapter contains General-use Programming Interface information.

General format
The 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 format
The 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 format
The format of a CICS command in an RPG II application program consists of an 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 a resource region in response to a distributed program link command:
Table 1. Restricted API commands
ADDRESS .... ALLOCATE ASSIGN .... CONNECT PROCESS CONVERSE EXTRACT PROCESS FREE CONVID HANDLE AID ISSUE .... PURGE MESSAGE RECEIVE .... ROUTE SEND .... SIGNOFF SIGNON WAIT TERMINAL

2

CICS User’s Handbook

API syntax

API command syntax

ABEND
──ABEND──┬──────────────┬───┬────────┬────┬────────┬─── └─ABCODE(name)─┘ └─CANCEL─┘ └─NODUMP─┘

ADDRESS
──ADDRESS──┬───────────────┬──┬───────────────────┬──┬──────────────┬──── └─ACEE(ptr-ref)─┘ └─COMMAREA(ptr-ref)─┘ └─CWA(ptr-ref)─┘ ──┬──────────────┬──┬────────────────┬──┬──────────────┬── └─EIB(ptr-ref)─┘ └─TCTUA(ptr-ref)─┘ └─TWA(ptr-ref)─┘

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

ALLOCATE (APPC)
──ALLOCATE──┬─SYSID(systemname)──┬───────────────┬─┬──┬─────────┬──────── │ └─PROFILE(name)─┘ │ └─NOQUEUE─┘ └─PARTNER(name)────────────────────────┘ ──┬─────────────┬── └─STATE(cvda)─┘

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

Chapter 1. Command-level application programming

3

API syntax

ALLOCATE (LUTYPE6.1)
──ALLOCATE──┬─SESSION(name)─────┬──┬───────────────┬──┬─────────┬── └─SYSID(systemname)─┘ └─PROFILE(name)─┘ └─NOQUEUE─┘

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

ALLOCATE (MRO)
──ALLOCATE──SYSID(systemname)──┬─────────┬──┬─────────────┬── └─NOQUEUE─┘ └─STATE(cvda)─┘

Conditions: INVREQ, SYSBUSY, SYSIDERR

ASKTIME
──ASKTIME──┬────────────────────┬── └─ABSTIME(data-area)─┘

4

CICS User’s Handbook

API syntax

ASSIGN
┌── ───────────────────────────┐ ┌── ───────────────────────────┐ ──ASSIGN───┬─────────────────────────┬┴───┬─────────────────────────┬┴── ├─ABCODE(data-area)───────┤ ├─MAPWIDTH(data-area)─────┤ ├─ABDUMP(data-area)───────┤ ├─MSRCONTROL(data-area)───┤ ├─ABPROGRAM(data-area)────┤ ├─NATLANGINUSE(data-area)─┤ ├─ACTIVITY(data-area)─────┤ ├─NETNAME(data-area)──────┤ ├─ACTIVITYID(data-area)───┤ ├─NEXTTRANSID(data-area)──┤ ├─ALTSCRNHT(data-area)────┤ ├─NUMTAB(data-area)───────┤ ├─ALTSCRNWD(data-area)────┤ ├─OPCLASS(data-area)──────┤ ├─APLKYBD(data-area)──────┤ ├─OPERKEYS(data-area)─────┤ ├─APLTEXT(data-area)──────┤ ├─OPID(data-area)─────────┤ ├─APPLID(data-area)───────┤ ├─OPSECURITY(data-area)───┤ ├─ASRAINTRPT(data-area)───┤ ├─ORGABCODE(data-area)────┤ ├─ASRAKEY(cvda)───────────┤ ├─OUTLINE(data-area)──────┤ ├─ASRAPSW(data-area)──────┤ ├─PAGENUM(data-area)──────┤ ├─ASRAREGS(data-area)─────┤ ├─PARTNPAGE(data-area)────┤ ├─ASRASPC(cvda)───────────┤ ├─PARTNS(data-area)───────┤ ├─ASRASTG(cvda)───────────┤ ├─PARTNSET(data-area)─────┤ ├─BRIDGE(data-area)───────┤ ├─PRINSYSID(data-area)────┤ ├─BTRANS(data-area)───────┤ ├─PROCESS(data-area)──────┤ ├─CMDSEC(data-area)───────┤ ├─PROCESSTYPE(data-area)──┤ ├─COLOR(data-area)────────┤ ├─PROGRAM(data-area)──────┤ ├─CWALENG(data-area)──────┤ ├─PS(data-area)───────────┤ ├─DEFSCRNHT(data-area)────┤ ├─QNAME(data-area)────────┤ ├─DEFSCRNWD(data-area)────┤ ├─RESSEC(data-area)───────┤ ├─DELIMITER(data-area)────┤ ├─RESTART(data-area)──────┤ ├─DESTCOUNT(data-area)────┤ ├─RETURNPROG(data-area)───┤ ├─DESTID(data-area)───────┤ ├─SCRNHT(data-area)───────┤ ├─DESTIDLENG(data-area)───┤ ├─SCRNWD(data-area)───────┤ ├─DSSCS(data-area)────────┤ ├─SIGDATA(data-area)──────┤ ├─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
──BIF DEEDIT──FIELD(data-area)──┬────────────────────┬── └─LENGTH(data-value)─┘

Condition: LENGERR

BUILD ATTACH (LUTYPE6.1)
──BUILD ATTACH──ATTACHID(name)──┬───────────────┬──┬────────────────┬──── └─PROCESS(name)─┘ └─RESOURCE(name)─┘ ──┬────────────────┬──┬─────────────────┬──┬─────────────┬──────────────── └─RPROCESS(name)─┘ └─RRESOURCE(name)─┘ └─QUEUE(name)─┘ ──┬────────────────────┬──┬─────────────────────┬───────────────────────── └─IUTYPE(data-value)─┘ └─DATASTR(data-value)─┘ ──┬───────────────────┬── └─RECFM(data-value)─┘

BUILD ATTACH (MRO)
──BUILD ATTACH──ATTACHID(name)──┬───────────────┬──┬────────────────┬──── └─PROCESS(name)─┘ └─RESOURCE(name)─┘ ──┬────────────────┬──┬─────────────────┬──┬─────────────┬──────────────── └─RPROCESS(name)─┘ └─RRESOURCE(name)─┘ └─QUEUE(name)─┘ ──┬────────────────────┬──┬─────────────────────┬───────────────────────── └─IUTYPE(data-value)─┘ └─DATASTR(data-value)─┘ ──┬───────────────────┬── └─RECFM(data-value)─┘

CANCEL
──CANCEL──┬───────────────────────────────────────────────────────┬── └─REQID(name)──┬───────────────────┬──┬───────────────┬─┘ └─SYSID(systemname)─┘ └─TRANSID(name)─┘

Conditions: ISCINVREQ, NOTAUTH, NOTFND, SYSIDERR

6

CICS User’s Handbook

API syntax

CHANGE PASSWORD
──CHANGE PASSWORD(data-value)──NEWPASSWORD(data-value)─────────────────── ──USERID(data-value)──┬──────────────────────┬──┬────────────────────┬── └─ESMREASON(data-area)─┘ └─ESMRESP(data-area)─┘

Conditions: INVREQ, NOTAUTH, USERIDERR

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

Condition: INVREQ

CONNECT PROCESS (APPC)
──CONNECT PROCESS──┬─CONVID(name)──┬───────────────────────────────────── └─SESSION(name)─┘ ──┬─PROCNAME(data-area)──┬────────────────────────┬─┬───────────────────── │ └─PROCLENGTH(data-value)─┘ │ └─PARTNER(name)───────────────────────────────────┘ ──┬───────────────────────────────────────────────┬─────────────────────── └─PIPLIST(data-area)──┬───────────────────────┬─┘ └─PIPLENGTH(data-value)─┘ ? ──SYNCLEVEL(data-value)──┬─────────────┬── └─STATE(cvda)─┘

?

?

Conditions: INVREQ, LENGERR, NOTALLOC, PARTNERIDERR, TERMERR

Chapter 1. Command-level application programming

7

API syntax

CONVERSE (APPC)
──CONVERSE──┬──────────────┬──FROM(data-area)──────────────────────────── └─CONVID(name)─┘ ──┬─FROMLENGTH(data-value)──┬──┬─INTO(data-area)─┬──────────────────────── └─FROMFLENGTH(data-value)─┘ └─SET(ptr-ref)────┘ ──┬─TOLENGTH(data-area)──┬──┬────────────────────────┬──────────────────── └─TOFLENGTH(data-area)─┘ ├─MAXLENGTH(data-value)──┤ └─MAXFLENGTH(data-value)─┘ ? ───┬────────────┬───┬─────────────┬── └─NOTRUNCATE─┘ └─STATE(cvda)─┘

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

CONVERSE (default)
──CONVERSE──FROM(data-area)──┬─FROMLENGTH(data-value)──┬───────────────── └─FROMFLENGTH(data-value)─┘ ──┬─INTO(data-area)─┬──┬─TOLENGTH(data-area)──┬─────────────────────────── └─SET(ptr-ref)────┘ └─TOFLENGTH(data-area)─┘ ──┬────────────────────────┬───┬────────────┬───┬────────────┬── ├─MAXLENGTH(data-value)──┤ └─NOTRUNCATE─┘ └─DEST(name)─┘ └─MAXFLENGTH(data-value)─┘

Conditions: LENGERR

8

CICS User’s Handbook

API syntax

CONVERSE (LUTYPE2/LUTYPE3)
──CONVERSE──FROM(data-area)──┬─FROMLENGTH(data-value)──┬───────────────── └─FROMFLENGTH(data-value)─┘ ──┬─INTO(data-area)─┬───────────────────────────────────────────────────── └─SET(ptr-ref)────┘ ──┬─┬──────────────────────┬──┬─────────────────────┬─┬─────────────────── │ └─ERASE──┬───────────┬─┘ └─CTLCHAR(data-value)─┘ │ │ ├─DEFAULT───┤ │ │ └─ALTERNATE─┘ │ └─STRFIELD──────────────────────────────────────────┘ ──┬─TOLENGTH(data-area)──┬──┬────────────────────────┬───┬─────────┬────── └─TOFLENGTH(data-area)─┘ ├─MAXLENGTH(data-value)──┤ └─DEFRESP─┘ └─MAXFLENGTH(data-value)─┘ ───┬────────────┬────┬──────┬─── └─NOTRUNCATE─┘ └─ASIS─┘

Conditions: EOC, LENGERR, TERMERR

CONVERSE (LUTYPE4)
──CONVERSE──FROM(data-area)──┬─FROMLENGTH(data-value)──┬───────────────── └─FROMFLENGTH(data-value)─┘ ──┬─INTO(data-area)─┬──┬─TOLENGTH(data-area)──┬───┬─────────┬───────────── └─SET(ptr-ref)────┘ └─TOFLENGTH(data-area)─┘ └─DEFRESP─┘ ──┬────────────────────────┬───┬─────┬────┬────────────┬─── ├─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)
──CONVERSE──┬───────────────────────────────────────────────────────┬──── └─FROM(data-area)──┬─FROMLENGTH(data-value)──┬──┬─────┬─┘ └─FROMFLENGTH(data-value)─┘ └─FMH─┘ ──┬───────────────┬──┬────────────────┬──┬─INTO(data-area)─┬────────────── ├─CONVID(name)──┤ └─ATTACHID(name)─┘ └─SET(ptr-ref)────┘ └─SESSION(name)─┘ ──┬─TOLENGTH(data-area)──┬──┬────────────────────────┬──────────────────── └─TOFLENGTH(data-area)─┘ ├─MAXLENGTH(data-value)──┤ └─MAXFLENGTH(data-value)─┘ ───┬────────────┬────┬─────────┬─── └─NOTRUNCATE─┘ └─DEFRESP─┘

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

CONVERSE (MRO)
──CONVERSE──┬───────────────┬──┬────────────────┬──────────────────────── ├─CONVID(name)──┤ └─ATTACHID(name)─┘ └─SESSION(name)─┘ ──┬───────────────────────────────────────────────────────┬─────────────── └─FROM(data-area)──┬─FROMLENGTH(data-value)──┬──┬─────┬─┘ └─FROMFLENGTH(data-value)─┘ └─FMH─┘ ──┬─INTO(data-area)─┬──┬─TOLENGTH(data-area)──┬─────────────────────────── └─SET(ptr-ref)────┘ └─TOFLENGTH(data-area)─┘ ──┬────────────────────────┬───┬────────────┬────┬─────────┬────────────── ├─MAXLENGTH(data-value)──┤ └─NOTRUNCATE─┘ └─DEFRESP─┘ └─MAXFLENGTH(data-value)─┘ ? ──┬─────────────┬── └─STATE(cvda)─┘

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

10

CICS User’s Handbook

API syntax

CONVERSE (SCS)
──CONVERSE──FROM(data-area)──┬─FROMLENGTH(data-value)──┬───────────────── └─FROMFLENGTH(data-value)─┘ ──┬─INTO(data-area)─┬──┬─TOLENGTH(data-area)──┬─────────────────────────── └─SET(ptr-ref)────┘ └─TOFLENGTH(data-area)─┘ ──┬────────────────────────┬───┬─────────┬────┬──────────┬──────────────── ├─MAXLENGTH(data-value)──┤ └─DEFRESP─┘ └─STRFIELD─┘ └─MAXFLENGTH(data-value)─┘ ───┬────────────┬─── └─NOTRUNCATE─┘

Conditions: LENGERR, TERMERR

CONVERSE (System/3)
──CONVERSE──FROM(data-area)──┬─FROMLENGTH(data-value)──┬───────────────── └─FROMFLENGTH(data-value)─┘ ──┬─INTO(data-area)─┬──┬─TOLENGTH(data-area)──┬─────────────────────────── └─SET(ptr-ref)────┘ └─TOFLENGTH(data-area)─┘ ──┬────────────────────────┬───┬────────────┬───┬────────────┬──────────── ├─MAXLENGTH(data-value)──┤ └─NOTRUNCATE─┘ └─DEST(name)─┘ └─MAXFLENGTH(data-value)─┘ ───┬──────┬─── └─ASIS─┘

Conditions: LENGERR

CONVERSE (System/7)
──CONVERSE──FROM(data-area)──┬─FROMLENGTH(data-value)──┬───────────────── └─FROMFLENGTH(data-value)─┘ ──┬─INTO(data-area)─┬──┬─TOLENGTH(data-area)──┬──┬────────────┬─────────── └─SET(ptr-ref)────┘ └─TOFLENGTH(data-area)─┘ └─DEST(name)─┘ ───┬──────┬────┬───────────┬─── └─ASIS─┘ └─PSEUDOBIN─┘

Condition: LENGERR

Chapter 1. Command-level application programming

11

API syntax

CONVERSE (2260)
──CONVERSE──FROM(data-area)──┬─FROMLENGTH(data-value)──┬───────────────── └─FROMFLENGTH(data-value)─┘ ──┬─INTO(data-area)─┬──┬─TOLENGTH(data-area)──┬─────────────────────────── └─SET(ptr-ref)────┘ └─TOFLENGTH(data-area)─┘ ──┬────────────────────────┬───┬────────────┬───────────────────────────── ├─MAXLENGTH(data-value)──┤ └─NOTRUNCATE─┘ └─MAXFLENGTH(data-value)─┘ ──┬─────────────────────┬──┬──────────────────────┬──┬────────────┬─────── └─CTLCHAR(data-value)─┘ └─LINEADDR(data-value)─┘ └─DEST(name)─┘ ───┬─────────┬─── └─LEAVEKB─┘

Condition: LENGERR

CONVERSE (2741)
──CONVERSE──FROM(data-area)──┬─FROMLENGTH(data-value)──┬───────────────── └─FROMFLENGTH(data-value)─┘ ──┬─INTO(data-area)─┬──┬─TOLENGTH(data-area)──┬─────────────────────────── └─SET(ptr-ref)────┘ └─TOFLENGTH(data-area)─┘ ──┬────────────────────────┬───┬────────────┬───┬────────────┬── ├─MAXLENGTH(data-value)──┤ └─NOTRUNCATE─┘ └─DEST(name)─┘ └─MAXFLENGTH(data-value)─┘

Conditions: LENGERR, RDATT, WRBRK

12

CICS User’s Handbook

API syntax

CONVERSE (3270 display)
──CONVERSE──FROM(data-area)──┬─FROMLENGTH(data-value)──┬───────────────── └─FROMFLENGTH(data-value)─┘ ──┬─INTO(data-area)─┬──┬─TOLENGTH(data-area)──┬─────────────────────────── └─SET(ptr-ref)────┘ └─TOFLENGTH(data-area)─┘ ──┬────────────────────────┬───┬────────────┬───────────────────────────── ├─MAXLENGTH(data-value)──┤ └─NOTRUNCATE─┘ └─MAXFLENGTH(data-value)─┘ ──┬─┬──────────────────────┬──┬─────────────────────┬─┬─────────────────── │ └─ERASE──┬───────────┬─┘ └─CTLCHAR(data-value)─┘ │ │ ├─DEFAULT───┤ │ │ └─ALTERNATE─┘ │ └─STRFIELD──────────────────────────────────────────┘ ──┬────────────┬───┬──────┬─── └─DEST(name)─┘ └─ASIS─┘

Condition: LENGERR

CONVERSE (3270 logical)
──CONVERSE──FROM(data-area)──┬─FROMLENGTH(data-value)──┬───────────────── └─FROMFLENGTH(data-value)─┘ ──┬─INTO(data-area)─┬───────────────────────────────────────────────────── └─SET(ptr-ref)────┘ ──┬─┬──────────────────────┬──┬─────────────────────┬─┬─────────────────── │ └─ERASE──┬───────────┬─┘ └─CTLCHAR(data-value)─┘ │ │ ├─DEFAULT───┤ │ │ └─ALTERNATE─┘ │ └─STRFIELD──────────────────────────────────────────┘ ──┬─TOLENGTH(data-area)──┬──┬────────────────────────┬───┬─────────┬────── └─TOFLENGTH(data-area)─┘ ├─MAXLENGTH(data-value)──┤ └─DEFRESP─┘ └─MAXFLENGTH(data-value)─┘ ───┬────────────┬────┬──────┬─── └─NOTRUNCATE─┘ └─ASIS─┘

Conditions: INVREQ, LENGERR, TERMERR

Chapter 1. Command-level application programming

13

API syntax

CONVERSE (3600 BTAM)
──CONVERSE──FROM(data-area)──┬─FROMLENGTH(data-value)──┬───────────────── └─FROMFLENGTH(data-value)─┘ ──┬─INTO(data-area)─┬──┬─TOLENGTH(data-area)──┬─────────────────────────── └─SET(ptr-ref)────┘ └─TOFLENGTH(data-area)─┘ ──┬────────────────────────┬───┬────────────┬────┬──────┬─── ├─MAXLENGTH(data-value)──┤ └─NOTRUNCATE─┘ └─ASIS─┘ └─MAXFLENGTH(data-value)─┘

Condition: LENGERR

CONVERSE (3600-3601)
──CONVERSE──FROM(data-area)──┬─FROMLENGTH(data-value)──┬───────────────── └─FROMFLENGTH(data-value)─┘ ──┬─INTO(data-area)─┬──┬─TOLENGTH(data-area)──┬──┬───────────┬──────────── └─SET(ptr-ref)────┘ └─TOFLENGTH(data-area)─┘ ├─LDC(name)─┤ └─FMH───────┘ ───┬─────────┬───┬────────────────────────┬───┬────────────┬─── └─DEFRESP─┘ ├─MAXLENGTH(data-value)──┤ └─NOTRUNCATE─┘ └─MAXFLENGTH(data-value)─┘

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

CONVERSE (3600-3614)
──CONVERSE──FROM(data-area)──┬─FROMLENGTH(data-value)──┬───────────────── └─FROMFLENGTH(data-value)─┘ ──┬─INTO(data-area)─┬──┬─TOLENGTH(data-area)──┬───┬─────────┬───────────── └─SET(ptr-ref)────┘ └─TOFLENGTH(data-area)─┘ └─DEFRESP─┘ ──┬────────────────────────┬───┬────────────┬─── ├─MAXLENGTH(data-value)──┤ └─NOTRUNCATE─┘ └─MAXFLENGTH(data-value)─┘

Conditions: LENGERR, TERMERR

14

CICS User’s Handbook

API syntax

CONVERSE (3650 interpreter)
──CONVERSE──FROM(data-area)──┬─FROMLENGTH(data-value)──┬───────────────── └─FROMFLENGTH(data-value)─┘ ──┬─INTO(data-area)─┬──┬─TOLENGTH(data-area)──┬───┬─────────┬───────────── └─SET(ptr-ref)────┘ └─TOFLENGTH(data-area)─┘ └─DEFRESP─┘ ───┬─────┬───┬────────────────────────┬───┬────────────┬─── └─FMH─┘ ├─MAXLENGTH(data-value)──┤ └─NOTRUNCATE─┘ └─MAXFLENGTH(data-value)─┘

Conditions: EOC, EODS, INBFMH, LENGERR, TERMERR

CONVERSE (3650-3270)
──CONVERSE──FROM(data-area)──┬─FROMLENGTH(data-value)──┬───────────────── └─FROMFLENGTH(data-value)─┘ ──┬─INTO(data-area)─┬──┬─TOLENGTH(data-area)──┬─────────────────────────── └─SET(ptr-ref)────┘ └─TOFLENGTH(data-area)─┘ ──┬─────────────────────┬──┬──────────────────────┬───┬─────────┬───────── └─CTLCHAR(data-value)─┘ └─ERASE──┬───────────┬─┘ └─DEFRESP─┘ ├─DEFAULT───┤ └─ALTERNATE─┘ ───┬─────┬───┬────────────────────────┬───┬────────────┬─── └─FMH─┘ ├─MAXLENGTH(data-value)──┤ └─NOTRUNCATE─┘ └─MAXFLENGTH(data-value)─┘

Conditions: LENGERR, TERMERR

CONVERSE (3650-3653)
──CONVERSE──FROM(data-area)──┬─FROMLENGTH(data-value)──┬───────────────── └─FROMFLENGTH(data-value)─┘ ──┬─INTO(data-area)─┬──┬─TOLENGTH(data-area)──┬───┬─────────┬───────────── └─SET(ptr-ref)────┘ └─TOFLENGTH(data-area)─┘ └─DEFRESP─┘ ──┬────────────────────────┬───┬────────────┬─── ├─MAXLENGTH(data-value)──┤ └─NOTRUNCATE─┘ └─MAXFLENGTH(data-value)─┘

Conditions: EOC, LENGERR, TERMERR

Chapter 1. Command-level application programming

15

API syntax

CONVERSE (3650-3680)
──CONVERSE──FROM(data-area)──┬─FROMLENGTH(data-value)──┬───────────────── └─FROMFLENGTH(data-value)─┘ ──┬─INTO(data-area)─┬──┬─TOLENGTH(data-area)──┬───┬─────┬───────────────── └─SET(ptr-ref)────┘ └─TOFLENGTH(data-area)─┘ └─FMH─┘ ───┬─────────┬───┬────────────────────────┬───┬────────────┬─── └─DEFRESP─┘ ├─MAXLENGTH(data-value)──┤ └─NOTRUNCATE─┘ └─MAXFLENGTH(data-value)─┘

Conditions: LENGERR, TERMERR

CONVERSE (3735)
──CONVERSE──FROM(data-area)──┬─FROMLENGTH(data-value)──┬───────────────── └─FROMFLENGTH(data-value)─┘ ──┬─INTO(data-area)─┬──┬─TOLENGTH(data-area)──┬─────────────────────────── └─SET(ptr-ref)────┘ └─TOFLENGTH(data-area)─┘ ──┬────────────────────────┬───┬────────────┬────┬──────┬─── ├─MAXLENGTH(data-value)──┤ └─NOTRUNCATE─┘ └─ASIS─┘ └─MAXFLENGTH(data-value)─┘

Conditions: EOF, LENGERR

CONVERSE (3740)
──CONVERSE──FROM(data-area)──┬─FROMLENGTH(data-value)──┬───────────────── └─FROMFLENGTH(data-value)─┘ ──┬─INTO(data-area)─┬──┬─TOLENGTH(data-area)──┬─────────────────────────── └─SET(ptr-ref)────┘ └─TOFLENGTH(data-area)─┘ ──┬────────────────────────┬───┬────────────┬────┬──────┬─── ├─MAXLENGTH(data-value)──┤ └─NOTRUNCATE─┘ └─ASIS─┘ └─MAXFLENGTH(data-value)─┘

Condition: LENGERR

16

CICS User’s Handbook

API syntax

CONVERSE (3767)
──CONVERSE──FROM(data-area)──┬─FROMLENGTH(data-value)──┬───────────────── └─FROMFLENGTH(data-value)─┘ ──┬─INTO(data-area)─┬──┬─TOLENGTH(data-area)──┬───┬─────────┬───────────── └─SET(ptr-ref)────┘ └─TOFLENGTH(data-area)─┘ └─DEFRESP─┘ ──┬────────────────────────┬───┬────────────┬─── ├─MAXLENGTH(data-value)──┤ └─NOTRUNCATE─┘ └─MAXFLENGTH(data-value)─┘

Conditions: EOC, LENGERR, SIGNAL, TERMERR

CONVERSE (3770)
──CONVERSE──FROM(data-area)──┬─FROMLENGTH(data-value)──┬───────────────── └─FROMFLENGTH(data-value)─┘ ──┬─INTO(data-area)─┬──┬─TOLENGTH(data-area)──┬───┬─────────┬───────────── └─SET(ptr-ref)────┘ └─TOFLENGTH(data-area)─┘ └─DEFRESP─┘ ───┬─────┬───┬────────────────────────┬───┬────────────┬─── └─FMH─┘ ├─MAXLENGTH(data-value)──┤ └─NOTRUNCATE─┘ └─MAXFLENGTH(data-value)─┘

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

CONVERSE (3790 full-function or inquiry)
──CONVERSE──FROM(data-area)──┬─FROMLENGTH(data-value)──┬───────────────── └─FROMFLENGTH(data-value)─┘ ──┬─INTO(data-area)─┬──┬─TOLENGTH(data-area)──┬───┬─────┬───────────────── └─SET(ptr-ref)────┘ └─TOFLENGTH(data-area)─┘ └─FMH─┘ ───┬─────────┬───┬────────────────────────┬───┬────────────┬─── └─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)
──CONVERSE──FROM(data-area)──┬─FROMLENGTH(data-value)──┬───────────────── └─FROMFLENGTH(data-value)─┘ ──┬─INTO(data-area)─┬──┬─TOLENGTH(data-area)──┬───┬─────────┬───────────── └─SET(ptr-ref)────┘ └─TOFLENGTH(data-area)─┘ └─DEFRESP─┘ ──┬─────────────────────┬───────────────────────────────────────────────── └─CTLCHAR(data-value)─┘ ──┬──────────────────────────────────────────────────────────────────┬── └─ERASE──┬───────────┬──┬────────────────────────┬──┬────────────┬─┘ ├─DEFAULT───┤ ├─MAXLENGTH(data-value)──┤ └─NOTRUNCATE─┘ └─ALTERNATE─┘ └─MAXFLENGTH(data-value)─┘

Conditions: LENGERR, TERMERR

DELAY
┌─INTERVAL( )──────────────────────┐ ──DELAY──┼──────────────────────────────────┼──┬─────────────┬── ├─INTERVAL(hhmmss)─────────────────┤ └─REQID(name)─┘ ├─TIME(hhmmss)─────────────────────┤ │ ┌── ───────────────────────┐ │ ├─FOR───┬─HOURS(data-value)───┬┴───┤ │ ├─MINUTES(data-value)─┤ │ │ └─SECONDS(data-value)─┘ │ │ ┌── ───────────────────────┐ │ └─UNTIL───┬─HOURS(data-value)───┬┴─┘ ├─MINUTES(data-value)─┤ └─SECONDS(data-value)─┘

Conditions: EXPIRED, INVREQ

18

CICS User’s Handbook

API syntax

DELETE
──DELETE──FILE(filename)──┬────────────────────────────────────────┬───── ├─TOKEN(data-area)───────────────────────┤ └─RIDFLD(data-area)──┬─────────────────┬─┘ └──┤ keylength ├──┘ ──┬───────────────────┬──┬───────────┬──┬─────┬── └─SYSID(systemname)─┘ └─NOSUSPEND─┘ ├─RBA─┤ └─RRN─┘ keylength: ├──KEYLENGTH(data-value)──┬─────────────────────────────────┬──┤ └─GENERIC──┬────────────────────┬─┘ └─NUMREC(data-value)─┘

|

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

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

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

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

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

Chapter 1. Command-level application programming

19

API syntax

DEQ
──DEQ──RESOURCE(data-area)──┬────────────────────┬─────────────────────── └─LENGTH(data-value)─┘ ? ? ? ┌─UOW───────────────┐ ──┼───────────────────┼── ├─MAXLIFETIME(cvda)─┤ └─TASK──────────────┘

Conditions: INVREQ, LENGERR

20

CICS User’s Handbook

API syntax

DFHMDF (1 of 2)
───┬─────┬───DFHMDF── └─fld─┘

┌─,─────────────────────────────────────────┐ ───┬─────────────────────────────────────────┬┴──────────────── ├─POS=─┬─number────────┬──────────────────┤ │ └─(line,column)─┘ │ ├─LENGTH=number───────────────────────────┤ ├─JUSTIFY=(─┬───────┬──┬──────────────┬─)─┤ │ ├─LEFT──┤ └─,─┬─BLANK─┬──┘ │ │ └─RIGHT─┘ └─ZERO──┘ │ ├─┬─INITIAL='char-data'───────┬───────────┤ │ ├─XINIT=hex-data────────────┤ │ (1) │ └─GINIT='DBCS-characters'───┘ │ ├─ATTRB=(─┤ att1 ├──┤ att2 ├─)────────────┤ │ ┌─DEFAULT─┐ │ ├─COLOR=─┼─────────┼──────────────────────┤ │ └─color───┘ │ │ ┌─BASE─┐ │ └─PS=─┼──────┼────────────────────────────┘ └─psid─┘ att1: ┌─ASKIP────────────┐ ├──┼──────────────────┼─────────────────────────────────────────┤ ├─PROT─────────────┤ └─UNPROT──┬──────┬─┘ └─,NUM─┘ att2: ├──┬──────────────────────────┬─────────────────────────────────┤ │ ┌── ─────────┐ │ └─,─┬─BRT──┬───┬───────┬┴──┘ ├─NORM─┤ ├─,DET──┤ └─DRK──┘ ├─,IC───┤ └─,FSET─┘
1

Notes: 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)
┌─,───────────────────────────────┐ ───┬───────────────────────────────┬┴── │ ┌─,───────────┐ │ ├─VALIDN=(──┬───────────┬┴─)────┤ │ ├─MUSTFILL──┤ │ │ ├─MUSTENTER─┤ │ │ └─TRIGGER───┘ │ ├─GRPNAME=group-name────────────┤ ├─OCCURS=number─────────────────┤ ├─PICIN='value'─────────────────┤ ├─PICOUT='value'────────────────┤ ├─OUTLINE=─┬─BOX─────────────┬──┤ │ │ ┌─,───────┐ │ │ │ └─(──┬───────┬┴─)─┘ │ │ ├─LEFT──┤ │ │ ├─RIGHT─┤ │ │ ├─OVER──┤ │ │ └─UNDER─┘ │ │ ┌─NO──┐ │ ├─SOSI=─┼─────┼─────────────────┤ │ └─YES─┘ │ │ ┌─YES─┐ │ ├─TRANSP=─┼─────┼───────────────┤ │ └─NO──┘ │ └─CASE=MIXED────────────────────┘

Minimum BMS:

22

CICS User’s Handbook

API syntax

DFHMDI
──map──DFHMDI──────────────────────────────────────────────────────────────── ┌─,─────────────────────────┐ ┌─,───────────────────────────────┐ ───┬─────────────────────────┬┴───┬───────────────────────────────┬┴── ├─SIZE=(line,column)──────┤ ├─PS=─┬─BASE─┬──────────────────┤ ├─TERM=type───────────────┤ │ └─psid─┘ │ │ ┌─,────────┐ │ │ ┌─,───────────┐ │ ├─CTRL=(──┬────────┬┴─)───┤ ├─VALIDN=──┬───────────┬┴───────┤ │ ├─PRINT──┤ │ │ ├─MUSTFILL──┤ │ │ ├─length─┤ │ │ ├─MUSTENTER─┤ │ │ ├─FREEKB─┤ │ │ └─TRIGGER───┘ │ │ ├─ALARM──┤ │ ├─COLUMN=number─────────────────┤ │ └─FRSET──┘ │ ├─LINE=number───────────────────┤ │ ┌─NO──────┐ │ ├─FIELDS=NO─────────────────────┤ ├─EXTATT=─┼─────────┼─────┤ │ ┌─,────────────┐ │ │ ├─MAPONLY─┤ │ ├──MAPATTS=(attr)┴──────────────┤ │ └─YES─────┘ │ │ ┌─,───────────┐ │ │ ┌─DEFAULT─┐ │ ├──DSATTS=(attr)┴───────────────┤ ├─COLOR=─┼─────────┼──────┤ ├─OUTLINE=─┬─BOX─────────────┬──┤ │ └─color───┘ │ │ │ ┌─,───────┐ │ │ │ ┌─NO──┐ │ │ └─(──┬───────┬┴─)─┘ │ ├─CURSLOC=─┼─────┼────────┤ │ ├─LEFT──┤ │ │ └─YES─┘ │ │ ├─RIGHT─┤ │ │ ┌─OFF───────┐ │ │ ├─OVER──┤ │ └─HILIGHT=─┼───────────┼──┘ │ └─UNDER─┘ │ ├─BLINK─────┤ │ ┌─NO──┐ │ ├─REVERSE───┤ ├─SOSI=─┼─────┼─────────────────┤ └─UNDERLINE─┘ │ └─YES─┘ │ │ ┌─YES─┐ │ ├─TRANSP=─┼─────┼───────────────┤ │ └─NO──┘ │ └─JUSTIFY=BOTTOM────────────────┘

Standard BMS: DFHMDI
┌─,───────────────────────────────┐ ───┬───────────────────────────────┬┴── ├─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
┌─,─────────────────────┐ ───┬─────────────────────┬┴── │ ┌─SAME───┐ │ ├─COLUMN=─┼────────┼──┤ │ ├─number─┤ │ │ └─NEXT───┘ │ │ ┌─NEXT───┐ │ ├─LINE=─┼────────┼────┤ │ ├─number─┤ │ │ └─SAME───┘ │ ├─JUSTIFY=(─┤ jst ├─)─┤ ├─HEADER=YES──────────┤ └─TRAILER=YES─────────┘ jst: ┌─LEFT──┐ ├──┼───────┼──┬──────────────┬──┤ └─RIGHT─┘ └─,─┬─FIRST─┬──┘ └─LAST──┘

DFHMDX
──DFHMDX──MAPSET=─┬─name─┬───┬──────────────┬──,MAP=─┬─name─┬──────────── └─ ────┘ └─,MODULE=name─┘ └─ ────┘ ──┬───────────────────────────────────────────┬─────────────────────────── └─,DOCTYPE=─┬─'-//W3C//DTD HTML 3.2//EN'─┬──┘ └─doctype────────────────────┘ ──┬─────────────────────┬──┬──────────────────────────────────────┬─────── └─,TITLE='title-text'─┘ └─,MASTHEAD=url─┬───────────────────┬──┘ └─,'alternate-text'─┘ ──┬─────────────────┬──┬──────────────────────┬──┬───────────────────┬──── └─,BACKGROUND=url─┘ └─,BGCOLOR=─┤ color ├──┘ └─,TEXT=─┤ color ├──┘ ──┬───────────────────┬──┬────────────────────┬─────────────────────────── └─,LINK=─┤ color ├──┘ └─,VLINK=─┤ color ├──┘ ──┬────────────────────┬──┬─────────────────────────────┬───────────────── └─,ALINK=─┤ color ├──┘ │ ┌─,────────────────────┐ │ └─,───┤ key ├─=─┤ button ├─┴──┘ ──┬─────────────────────────────────┬──┬─────────────────────┬──────────── │ ┌─,────────────────────────┐ │ │ ┌─YES────┐ │ └─,───┤ bmscolor ├─=─┤ color ├─┴──┘ └─,RESET=─┼─NO─────┼──┘ └─'text'─┘ ──┬─────────────────────────────────────────────────┬───────────────────── │ ┌─,───────┐ │ └─,SUPPRESS=(──(row,col)┴──┬───────┬──┬───────┬─)─┘ └─,HEAD─┘ └─,FOOT─┘ ──┬────────────────┬──┬──────────────────┬──┬─────────────────────┬── └─,ONLOAD='text'─┘ └─,ONUNLOAD='text'─┘ │ ┌─NO──┐ │ └─,PROPFONT=─┴─YES─┴──┘

Minimum BMS:

24

CICS User’s Handbook

API syntax

DFHMSD
──mapset──DFHMSD──TYPE=─┬─DSECT─┬──────────────────────────────────────── ├─MAP───┤ └─FINAL─┘ ┌─,───────────────────────┐ ┌─,───────────────────────────────┐ ───┬───────────────────────┬┴───┬───────────────────────────────┬┴── │ ┌─OUT───┐ │ │ ┌─NO──┐ │ ├─MODE=─┼───────┼───────┤ ├─CURSLOC=─┼─────┼──────────────┤ │ ├─IN────┤ │ │ └─YES─┘ │ │ └─INOUT─┘ │ │ ┌─OFF───────┐ │ │ ┌─LOWER─┐ │ ├─HILIGHT=─┼───────────┼────────┤ ├─FOLD=─┼───────┼───────┤ │ ├─BLINK─────┤ │ │ └─UPPER─┘ │ │ ├─REVERSE───┤ │ │ ┌─NO──┐ │ │ └─UNDERLINE─┘ │ ├─TRIGRAPH=─┼─────┼─────┤ ├─PS=─┬─BASE─┬──────────────────┤ │ └─YES─┘ │ │ └─psid─┘ │ │ ┌─ASM────┐ │ │ ┌─,───────────┐ │ ├─LANG=─┼────────┼──────┤ ├─VALIDN=──┬───────────┬┴───────┤ │ ├─COBOL──┤ │ │ ├─MUSTFILL──┤ │ │ ├─COBOL2─┤ │ │ ├─MUSTENTER─┤ │ │ ├─PLI────┤ │ │ ├─TRIGGER───┤ │ │ └─C──────┘ │ │ └─USEREXIT──┘ │ ├─┬──────────────┬──────┤ ├─┬─TERM=type─┬─────────────────┤ │ ├─STORAGE=AUTO─┤ │ │ └─SUFFIX=n──┘ │ │ └─BASE=name────┘ │ │ ┌─NO──┐ │ │ ┌─,────────┐ │ ├─TIOAPFX=─┼─────┼──────────────┤ ├─CTRL=(──┬────────┬┴─)─┤ │ └─YES─┘ │ │ ├─PRINT──┤ │ │ ┌─,────────────┐ │ │ ├─length─┤ │ ├──MAPATTS=(attr)┴──────────────┤ │ ├─FREEKB─┤ │ │ ┌─,───────────┐ │ │ ├─ALARM──┤ │ ├──DSATTS=(attr)┴───────────────┤ │ └─FRSET──┘ │ ├─OUTLINE=─┬─BOX─────────────┬──┤ │ ┌─NO──────┐ │ │ │ ┌─,───────┐ │ │ ├─EXTATT=─┼─────────┼───┤ │ └─(──┬───────┬┴─)─┘ │ │ ├─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
┌─,───────────────────────────────┐ ───┬───────────────────────────────┬┴── ├─PARTN=(name)─┬─────────────┬──┤ │ └─,──ACTIVATE─┘ │ ├─LDC=mnemonic──────────────────┤ │ ┌─NO──┐ │ ├─OBFMT=─┼─────┼────────────────┤ │ └─YES─┘ │ │ ┌─,─────┐ │ ├─HTAB=────tab──┴───────────────┤ │ ┌─,─────┐ │ ├─VTAB=────tab──┴───────────────┤ │ ┌─FIELD─┐ │ ├─DATA=─┼───────┼───────────────┤ │ └─BLOCK─┘ │ └─FLDSEP=─┬─char────────┬───────┘ └─X'hex-char'─┘

DFHPDI
───┬───────┬───DFHPDI──VIEWPOS=(lines,columns)─────────────────────────── └─partn─┘ ┌─,────────────────────────┐ ──,VIEWSZE=(lines,columns)───┬────────────────────────┬┴── ├─BUFSZE=(lines,columns)─┤ ├─CHARSZE=(vpels,hpels)──┤ ├─MAPSFX=mapset-suffix───┤ └─ATTRB=ERROR────────────┘

DFHPSD
┌─,─────────────────────────┐ ──partnset DFHPSD───┬─────────────────────────┬┴── ├─SUFFIX=user-suffix──────┤ ├─ALTSCRN=(lines,columns)─┤ └─CHARSZE=(vpels,hpels)───┘

26

CICS User’s Handbook

API syntax

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

DOCUMENT CREATE
──DOCUMENT──CREATE──DOCTOKEN(data-area)────────────────────────────────── ──┬─────────────────────────────────────────────────┬───────────────────── └──┬─┬─FROM(data-area)───┬──LENGTH(data-value)─┬──┘ │ ├─TEXT(data-area)───┤ │ │ └─BINARY(data-area)─┘ │ ├─FROMDOC(data-area)────────────────────────┤ └─TEMPLATE(name)────────────────────────────┘ ──┬─────────────────────────────────────────────┬───────────────────────── └─SYMBOLLIST(data-area)LISTLENGTH(data-value)─┘ ──┬────────────────────┬──┬────────────────────┬── └─DOCSIZE(data-area)─┘ └─HOSTCODEPAGE(name)─┘

Conditions: INVREQ, NOTFND, SYMBOLERR, TEMPLATERR

DOCUMENT INSERT
──DOCUMENT──INSERT──DOCTOKEN(data-area)────────────────────────────────── ──┬─┬─TEXT(data-area)───┬──LENGTH(data-value)─┬─────────────────────────── │ ├─BINARY(data-area)─┤ │ │ └─FROM(data-area)───┘ │ ├─SYMBOL(name)──────────────────────────────┤ ├─TEMPLATE(name)────────────────────────────┤ ├─FROMDOC(data-area)────────────────────────┤ └─BOOKMARK(name)────────────────────────────┘ ──┬─────────────────────┬──┬────────────────────┬───────────────────────── └─DOCSIZE(data-value)─┘ └─HOSTCODEPAGE(name)─┘ ──┬────────────────────────┬── └─AT(name)──┬──────────┬─┘ └─TO(name)─┘

Conditions: DUPREC, INVREQ, NOTFND, TEMPLATERR

Chapter 1. Command-level application programming

27

API syntax

DOCUMENT RETRIEVE
──DOCUMENT──RETRIEVE──DOCTOKEN(data-area)──INTO(data-area)─────────────── ──LENGTH(data-value)──MAXLENGTH(data-value)──┬────────────────────┬─────── └─CLNTCODEPAGE(name)─┘ ──┬──────────┬── └─DATAONLY─┘

Conditions: LENGERR, NOTFND

DOCUMENT SET
──DOCUMENT──SET──DOCTOKEN(data-area)───────────────────────────────────── ──┬─SYMBOL(name)──VALUE(data-area)─┬──LENGTH(data-value)── └─SYMBOLLIST(data-area)──────────┘

Conditions: NOTFND, SYMBOLERR

DUMP TRANSACTION
──DUMP TRANSACTION──DUMPCODE(name)─────────────────────────────────────── ──┬──────────────────────────────────────────┬───┬──────────┬───────────── └─FROM(data-area)──┬─LENGTH(data-value)──┬─┘ └─COMPLETE─┘ └─FLENGTH(data-value)─┘ ───┬─────┬──────────────────────────────────────────────────────────────── └─TRT─┘ ──┬────────────────────────────────────────────────────────────────┬────── └─┤ segmentlist ├──LENGTHLIST(data-area)──NUMSEGMENTS(data-area)─┘ ───┬──────┬────┬─────────┬────┬─────────┬────┬──────────┬───────────────── └─TASK─┘ └─STORAGE─┘ └─PROGRAM─┘ └─TERMINAL─┘ ───┬────────┬────┬─────┬────┬─────┬────┬─────┬────┬─────┬────┬─────┬────── └─TABLES─┘ └─DCT─┘ └─FCT─┘ └─PCT─┘ └─PPT─┘ └─SIT─┘ ───┬─────┬───┬───────────────────┬── └─TCT─┘ └─DUMPID(data-area)─┘ segmentlist: ├──SEGMENTLIST(data-area)──┤

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

28

CICS User’s Handbook

API syntax

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

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

ENQ
──ENQ──RESOURCE(data-area)──┬────────────────────┬─────────────────────── └─LENGTH(data-value)─┘ ┌─UOW───────────────┐ ──┼───────────────────┼───┬───────────┬─── ├─MAXLIFETIME(cvda)─┤ └─NOSUSPEND─┘ └─TASK──────────────┘

?

Conditions: ENQBUSY, INVREQ, LENGERR

ENTER TRACENUM
──ENTER TRACENUM(data-value)───────────────────────────────────────────── ──┬────────────────────────────────────────────┬──┬────────────────┬────── └─FROM(data-area)──┬───────────────────────┬─┘ └─RESOURCE(name)─┘ └─FROMLENGTH(data-area)─┘ ───┬───────────┬─── └─EXCEPTION─┘

?

?

Conditions: INVREQ, LENGERR

Chapter 1. Command-level application programming

29

API syntax

EXTRACT ATTACH (LUTYPE6.1)
──EXTRACT ATTACH──┬────────────────┬──┬────────────────────┬───────────── ├─ATTACHID(name)─┤ └─PROCESS(data-area)─┘ ├─CONVID(name)───┤ └─SESSION(name)──┘ ──┬─────────────────────┬──┬─────────────────────┬──────────────────────── └─RESOURCE(data-area)─┘ └─RPROCESS(data-area)─┘ ──┬──────────────────────┬──┬──────────────────┬────────────────────────── └─RRESOURCE(data-area)─┘ └─QUEUE(data-area)─┘ ──┬───────────────────┬──┬────────────────────┬──┬──────────────────┬── └─IUTYPE(data-area)─┘ └─DATASTR(data-area)─┘ └─RECFM(data-area)─┘

Conditions: CBIDERR, INVREQ, NOTALLOC

EXTRACT ATTACH (MRO)
──EXTRACT ATTACH──┬────────────────┬──┬────────────────────┬───────────── ├─ATTACHID(name)─┤ └─PROCESS(data-area)─┘ ├─CONVID(name)───┤ └─SESSION(name)──┘ ──┬─────────────────────┬──┬─────────────────────┬──────────────────────── └─RESOURCE(data-area)─┘ └─RPROCESS(data-area)─┘ ──┬──────────────────────┬──┬──────────────────┬────────────────────────── └─RRESOURCE(data-area)─┘ └─QUEUE(data-area)─┘ ──┬───────────────────┬──┬────────────────────┬──┬──────────────────┬── └─IUTYPE(data-area)─┘ └─DATASTR(data-area)─┘ └─RECFM(data-area)─┘

Conditions: CBIDERR, INVREQ, NOTALLOC

EXTRACT ATTRIBUTES (APPC)
──EXTRACT ATTRIBUTES──┬──────────────┬──STATE(cvda)── └─CONVID(name)─┘

Conditions: INVREQ, NOTALLOC

30

CICS User’s Handbook

API syntax

EXTRACT ATTRIBUTES (MRO)
──EXTRACT ATTRIBUTES──┬───────────────┬──STATE(cvda)── ├─CONVID(name)──┤ └─SESSION(name)─┘

Conditions: INVREQ, NOTALLOC

EXTRACT CERTIFICATE
──EXTRACT CERTIFICATE(ptr-ref)──┬───────────────────┬──────────────────── └─LENGTH(data-area)─┘ ──┬────────────────────┬──┬─────────────────────────┬───────────────────── └─SERIALNUM(ptr-ref)─┘ └─SERIALNUMLEN(data-area)─┘ ┌─OWNER──┐ ──┬─────────────────┬──┼────────┼──┬─────────────────────┬──────────────── └─USERID(ptr-ref)─┘ └─ISSUER─┘ └─COMMONNAME(ptr-ref)─┘ ──┬─────────────────────────┬──┬──────────────────┬─────────────────────── └─COMMONNAMLEN(data-area)─┘ └─COUNTRY(ptr-ref)─┘ ──┬───────────────────────┬──┬────────────────┬─────────────────────────── └─COUNTRYLEN(data-area)─┘ └─STATE(ptr-ref)─┘ ──┬─────────────────────┬──┬───────────────────┬────────────────────────── └─STATELEN(data-area)─┘ └─LOCALITY(ptr-ref)─┘ ──┬────────────────────────┬──┬───────────────────────┬─────────────────── └─LOCALITYLEN(data-area)─┘ └─ORGANIZATION(ptr-ref)─┘ ──┬─────────────────────────┬──┬──────────────────┬─────────────────────── └─ORGANIZATLEN(data-area)─┘ └─ORGUNIT(ptr-ref)─┘ ──┬───────────────────────┬── └─ORGUNITLEN(data-area)─┘

Conditions: INVREQ, LENGERR

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

?

Condition: NOTALLOC

Chapter 1. Command-level application programming

31

API syntax

EXTRACT PROCESS (APPC)
──EXTRACT PROCESS──────────────────────────────────────────────────────── ──┬────────────────────────────────────────────────────────────┬────────── └─PROCNAME(data-area)──PROCLENGTH(data-area)──┤ maxproclen ├─┘ ──┬──────────────┬──┬──────────────────────┬────────────────────────────── └─CONVID(name)─┘ └─SYNCLEVEL(data-area)─┘ ──┬────────────────────────────────────────┬── └─PIPLIST(ptr-ref)──PIPLENGTH(data-area)─┘ maxproclen: ├──┬────────────────────────┬──┤ └─MAXPROCLEN(data-value)─┘

?

?

Conditions: INVREQ, LENGERR, NOTALLOC

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

?

Condition: INVREQ, NOTALLOC

32

CICS User’s Handbook

API syntax

FORMATTIME
──FORMATTIME──ABSTIME(data-area)──┬─────────────────┬──────────────────── └─DATE(data-area)─┘ ──┬─────────────────────┬──┬─────────────────────┬──────────────────────── └─FULLDATE(data-area)─┘ └─DATEFORM(data-area)─┘ ──┬───────────────────────────┬──┬─────────────────────┬────────────────── └─DATESEP──┬──────────────┬─┘ └─DAYCOUNT(data-area)─┘ └─(data-value)─┘ ──┬───────────────────────┬──┬──────────────────────┬───────────────────── └─DAYOFMONTH(data-area)─┘ └─DAYOFWEEK(data-area)─┘ ──┬───────────────────┬──┬─────────────────────┬────────────────────────── └─DDMMYY(data-area)─┘ └─DDMMYYYY(data-area)─┘ ──┬───────────────────┬──┬─────────────────────┬────────────────────────── └─MMDDYY(data-area)─┘ └─MMDDYYYY(data-area)─┘ ──┬────────────────────────┬────────────────────────────────────────────── └─MONTHOFYEAR(data-area)─┘ ──┬────────────────────────────────────────────────┬────────────────────── └─TIME(data-area)──┬───────────────────────────┬─┘ └─TIMESEP──┬──────────────┬─┘ └─(data-value)─┘ ──┬─────────────────┬──┬──────────────────┬──┬───────────────────┬──────── └─YEAR(data-area)─┘ └─YYDDD(data-area)─┘ └─YYDDMM(data-area)─┘ ──┬───────────────────┬──┬────────────────────┬─────────────────────────── └─YYMMDD(data-area)─┘ └─YYYYDDD(data-area)─┘ ──┬─────────────────────┬──┬─────────────────────┬── └─YYYYDDMM(data-area)─┘ └─YYYYMMDD(data-area)─┘

Condition: INVREQ

FREE
──FREE──

Condition: NOTALLOC

FREE (APPC)
? ──FREE──┬──────────────┬──┬─────────────┬── └─CONVID(name)─┘ └─STATE(cvda)─┘

Conditions: INVREQ, NOTALLOC

Chapter 1. Command-level application programming

33

API syntax

FREE (LUTYPE6.1)
──FREE──┬───────────────┬── ├─CONVID(name)──┤ └─SESSION(name)─┘

Conditions: INVREQ, NOTALLOC

FREE (MRO)
? ──FREE──┬───────────────┬──┬─────────────┬── ├─CONVID(name)──┤ └─STATE(cvda)─┘ └─SESSION(name)─┘

Conditions: INVREQ, NOTALLOC

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

Condition: INVREQ

GDS ALLOCATE (APPC basic)
? ──GDS ALLOCATE──┬─SYSID(systemname)──┬────────────────┬─┬──────────────── │ └─MODENAME(name)─┘ │ └─PARTNER(name)─────────────────────────┘ ──CONVID(data-area)──RETCODE(data-area)───┬─────────┬───────────────────── └─NOQUEUE─┘ ? ──┬─────────────┬── └─STATE(cvda)─┘

34

CICS User’s Handbook

API syntax

GDS ASSIGN (APPC basic)
──GDS ASSIGN──┬───────────────────────┬──┬──────────────────────┬──────── └─PRINCONVID(data-area)─┘ └─PRINSYSID(data-area)─┘ ──RETCODE(data-area)──

GDS CONNECT PROCESS (APPC basic)
──GDS CONNECT PROCESS──CONVID(name)────────────────────────────────────── ──┬─PROCNAME(name)──┬────────────────────────┬─┬────────────────────────── │ └─PROCLENGTH(data-value)─┘ │ └─PARTNER(name)──────────────────────────────┘ ──┬───────────────────────────────────────────────┬─────────────────────── └─PIPLIST(data-area)──┬───────────────────────┬─┘ └─PIPLENGTH(data-value)─┘ ──SYNCLEVEL(data-value)──CONVDATA(data-area)──RETCODE(data-area)────────── ? ──┬─────────────┬── └─STATE(cvda)─┘

?

GDS EXTRACT ATTRIBUTES (APPC basic)
──GDS EXTRACT ATTRIBUTES──CONVID(name)──┬─────────────┬────────────────── └─STATE(cvda)─┘ ──CONVDATA(data-area)──RETCODE(data-area)──

GDS EXTRACT PROCESS (APPC basic)
──GDS EXTRACT PROCESS──CONVID(name)────────────────────────────────────── ──┬────────────────────────────────────────────────────────────┬────────── └─PROCNAME(data-area)──PROCLENGTH(data-area)──┤ maxproclen ├─┘ ──┬──────────────────────┬──────────────────────────────────────────────── └─SYNCLEVEL(data-area)─┘ ──┬────────────────────────────────────────────┬──RETCODE(data-area)── └─PIPLIST(pointer-ref)──PIPLENGTH(data-area)─┘ maxproclen: ├──┬────────────────────────┬──┤ └─MAXPROCLEN(data-value)─┘

?

Chapter 1. Command-level application programming

35

API syntax

GDS FREE (APPC basic)
──GDS FREE──CONVID(name)──CONVDATA(data-area)──RETCODE(data-area)──────── ? ──┬─────────────┬── └─STATE(cvda)─┘

GDS ISSUE ABEND (APPC basic)
──GDS ISSUE ABEND──CONVID(name)──CONVDATA(data-area)───────────────────── ? ──RETCODE(data-area)──┬─────────────┬── └─STATE(cvda)─┘

GDS ISSUE CONFIRMATION (APPC basic)
──GDS ISSUE CONFIRMATION──CONVID(name)──CONVDATA(data-area)────────────── ? ──RETCODE(data-area)──┬─────────────┬── └─STATE(cvda)─┘

GDS ISSUE ERROR (APPC basic)
──GDS ISSUE ERROR──CONVID(name)──CONVDATA(data-area)───────────────────── ? ──RETCODE(data-area)──┬─────────────┬── └─STATE(cvda)─┘

GDS ISSUE PREPARE (APPC basic)
──GDS ISSUE PREPARE──CONVID(name)──CONVDATA(data-area)─────────────────── ? ──RETCODE(data-area)──┬─────────────┬── └─STATE(cvda)─┘

36

CICS User’s Handbook

API syntax

GDS ISSUE SIGNAL (APPC basic)
──GDS ISSUE SIGNAL──CONVID(name)──CONVDATA(data-area)──────────────────── ? ──RETCODE(data-area)──┬─────────────┬── └─STATE(cvda)─┘

GDS RECEIVE (APPC basic)
──GDS RECEIVE──CONVID(name)──┬─INTO(data-area)──┬──FLENGTH(data-area)──── └─SET(pointer-ref)─┘ ──┬────────────────────────┬──┬─BUFFER─┬──CONVDATA(data-area)───────────── └─MAXFLENGTH(data-value)─┘ └─LLID───┘ ? ──RETCODE(data-area)──┬─────────────┬── └─STATE(cvda)─┘

GDS SEND (APPC basic)
──GDS SEND──CONVID(name)──┬──────────────────────────────────────┬─────── └─FROM(data-area)──FLENGTH(data-value)─┘ ──┬────────┬──┬─────────┬──CONVDATA(data-area)──RETCODE(data-area)──────── ├─INVITE─┤ ├─CONFIRM─┤ └─LAST───┘ └─WAIT────┘ ? ──┬─────────────┬── └─STATE(cvda)─┘

GDS WAIT (APPC basic)
──GDS WAIT──CONVID(name)──CONVDATA(data-area)──RETCODE(data-area)──────── ? ──┬─────────────┬── └─STATE(cvda)─┘

Chapter 1. Command-level application programming

37

API syntax

GETMAIN
──GETMAIN──SET(ptr-ref)──┬─FLENGTH(data-value)──┬───────┬─┬────────────── │ └─BELOW─┘ │ └─LENGTH(data-value)─────────────┘ ──┬─────────────────────┬───┬────────┬────┬───────────┬─────────────────── └─INITIMG(data-value)─┘ └─SHARED─┘ └─NOSUSPEND─┘ ? ? ──┬─────────────┬── ├─USERDATAKEY─┤ └─CICSDATAKEY─┘

Conditions: LENGERR, NOSTG

HANDLE ABEND
┌─CANCEL────────┐ ──HANDLE ABEND──┼───────────────┼── ├─PROGRAM(name)─┤ ├─LABEL(label)──┤ └─RESET─────────┘

?

Conditions: NOTAUTH, PGMIDERR (PROGRAM only)

HANDLE AID
┌── ─────────────────────────┐ ──HANDLE AID───┬───────────────────────┬┴── ├─ANYKEY──┬─────────┬───┤ │ └─(label)─┘ │ ├─CLEAR──┬─────────┬────┤ │ └─(label)─┘ │ ├─CLRPARTN──┬─────────┬─┤ │ └─(label)─┘ │ ├─ENTER──┬─────────┬────┤ │ └─(label)─┘ │ ├─LIGHTPEN──┬─────────┬─┤ │ └─(label)─┘ │ ├─OPERID──┬─────────┬───┤ │ └─(label)─┘ │ ├─PA1-PA3──┬─────────┬──┤ │ └─(label)─┘ │ ├─PF1-PF24──┬─────────┬─┤ │ └─(label)─┘ │ └─TRIGGER──┬─────────┬──┘ └─(label)─┘

Condition: INVREQ

38

CICS User’s Handbook

API syntax

HANDLE CONDITION
┌── ────────────────────────┐ ──HANDLE CONDITION────condition──┬─────────┬─┴── └─(label)─┘

IGNORE CONDITION
┌── ───────────┐ ──IGNORE CONDITION────condition─┴──

ISSUE ABEND (APPC)
? ──ISSUE ABEND──┬──────────────┬──┬─────────────┬── └─CONVID(name)─┘ └─STATE(cvda)─┘

Conditions: INVREQ, NOTALLOC, TERMERR

ISSUE ABORT
──ISSUE ABORT──┬────────────────────────────────────────────────┬──────── ├─DESTID(data-value)──┬────────────────────────┬─┤ │ └─DESTIDLENG(data-value)─┘ │ │ ┌─CONSOLE──┐ │ └─SUBADDR(data-value)──┼──────────┼──────────────┘ ├─PRINT────┤ ├─CARD─────┤ ├─WPMEDIA1─┤ ├─WPMEDIA2─┤ ├─WPMEDIA3─┤ └─WPMEDIA4─┘ ──┬────────────────────────────────────────────────┬── └─VOLUME(data-value)──┬────────────────────────┬─┘ └─VOLUMELENG(data-value)─┘

Conditions: FUNCERR, INVREQ, SELNERR, UNEXPIN

Chapter 1. Command-level application programming

39

API syntax

ISSUE ADD
──ISSUE ADD──DESTID(data-value)──┬────────────────────────┬────────────── └─DESTIDLENG(data-value)─┘ ──VOLUME(data-value)──┬────────────────────────┬──FROM(data-area)───────── └─VOLUMELENG(data-value)─┘ ──┬────────────────────┬──┬────────────────────┬───┬─────────┬──────────── └─LENGTH(data-value)─┘ └─NUMREC(data-value)─┘ └─DEFRESP─┘ ───┬────────┬───┬────────────────────────┬── └─NOWAIT─┘ └─RIDFLD(data-area)──RRN─┘

Conditions: FUNCERR, INVREQ, SELNERR, UNEXPIN

ISSUE CONFIRMATION (APPC)
? ──ISSUE CONFIRMATION──┬──────────────┬──┬─────────────┬── └─CONVID(name)─┘ └─STATE(cvda)─┘

Conditions: INVREQ, NOTALLOC, SIGNAL, TERMERR

ISSUE COPY (3270 display)
──ISSUE COPY──TERMID(name)──┬─────────────────────┬───┬──────┬─── └─CTLCHAR(data-value)─┘ └─WAIT─┘

?

Condition: NOTALLOC, TERMIDERR

ISSUE COPY (3270 logical)
──ISSUE COPY──TERMID(name)──┬─────────────────────┬───┬──────┬─── └─CTLCHAR(data-value)─┘ └─WAIT─┘

?

Conditions: LENGERR, NOTALLOC, TERMERR

40

CICS User’s Handbook

API syntax

ISSUE DISCONNECT (default)
──ISSUE DISCONNECT──

Conditions: SIGNAL, TERMERR

ISSUE DISCONNECT (LUTYPE6.1)
──ISSUE DISCONNECT──┬───────────────┬── └─SESSION(name)─┘

Conditions: NOTALLOC, TERMERR

ISSUE END
──ISSUE END──┬────────────────────────────────────────────────┬────────── ├─DESTID(data-value)──┬────────────────────────┬─┤ │ └─DESTIDLENG(data-value)─┘ │ │ ┌─CONSOLE──┐ │ └─SUBADDR(data-value)──┼──────────┼──────────────┘ ├─PRINT────┤ ├─CARD─────┤ ├─WPMEDIA1─┤ ├─WPMEDIA2─┤ ├─WPMEDIA3─┤ └─WPMEDIA4─┘ ──┬────────────────────────────────────────────────┬── └─VOLUME(data-value)──┬────────────────────────┬─┘ └─VOLUMELENG(data-value)─┘

Conditions: FUNCERR, INVREQ, SELNERR, UNEXPIN

ISSUE ENDFILE
──ISSUE ENDFILE───┬───────────┬─── └─ENDOUTPUT─┘

?

Condition: INVREQ, NOTALLOC

Chapter 1. Command-level application programming

41

API syntax

ISSUE ENDOUTPUT
──ISSUE ENDOUTPUT───┬─────────┬─── └─ENDFILE─┘

?

Condition: INVREQ, NOTALLOC

ISSUE EODS
──ISSUE EODS──

?

Conditions: INVREQ, NOTALLOC, TERMERR

ISSUE ERASE
──ISSUE ERASE──DESTID(data-value)──┬────────────────────────┬──────────── └─DESTIDLENG(data-value)─┘ ──VOLUME(data-value)──┬────────────────────────┬──RIDFLD(data-area)─────── └─VOLUMELENG(data-value)─┘ ──┬─KEYLENGTH(data-value)──┬───────────────────────┬─┬──────────────────── │ └─KEYNUMBER(data-value)─┘ │ └─RRN──────────────────────────────────────────────┘ ──┬────────────────────┬───┬─────────┬────┬────────┬─── └─NUMREC(data-value)─┘ └─DEFRESP─┘ └─NOWAIT─┘

Conditions: FUNCERR, INVREQ, SELNERR, UNEXPIN

ISSUE ERASEAUP
──ISSUE ERASEAUP───┬──────┬─── └─WAIT─┘

?

Conditions: INVREQ, NOTALLOC, TERMERR

42

CICS User’s Handbook

API syntax

ISSUE ERROR (APPC)
? ──ISSUE ERROR──┬──────────────┬──┬─────────────┬── └─CONVID(name)─┘ └─STATE(cvda)─┘

Conditions: INVREQ, NOTALLOC, SIGNAL, TERMERR

ISSUE LOAD
──ISSUE LOAD──PROGRAM(name)───┬──────────┬─── └─CONVERSE─┘

?

Conditions: NONVAL, NOTALLOC, NOSTART, TERMERR

ISSUE NOTE
──ISSUE NOTE──DESTID(data-value)──┬────────────────────────┬───────────── └─DESTIDLENG(data-value)─┘ ──VOLUME(data-value)──┬────────────────────────┬──RIDFLD(data-area)─────── └─VOLUMELENG(data-value)─┘ ──RRN──

Conditions: FUNCERR, INVREQ, SELNERR, UNEXPIN

ISSUE PASS
──ISSUE PASS──LUNAME(name)──┬─────────────────────────────────────┬────── └─FROM(data-area)──LENGTH(data-value)─┘ ? ? ──┬─────────────────────┬───┬───────────┬─── ├─LOGMODE(data-value)─┤ └─NOQUIESCE─┘ └─LOGONLOGMODE────────┘

?

Conditions: INVREQ, LENGERR, NOTALLOC

Chapter 1. Command-level application programming

43

API syntax

ISSUE PREPARE (APPC)
? ──ISSUE PREPARE──┬──────────────┬──┬─────────────┬── └─CONVID(name)─┘ └─STATE(cvda)─┘

?

Conditions: INVREQ, NOTALLOC, TERMERR

ISSUE PRINT
──ISSUE PRINT──

?

Conditions: INVREQ, NOTALLOC, TERMERR

ISSUE QUERY
──ISSUE QUERY──DESTID(data-value)──┬────────────────────────┬──────────── └─DESTIDLENG(data-value)─┘ ──┬────────────────────────────────────────────────┬── └─VOLUME(data-value)──┬────────────────────────┬─┘ └─VOLUMELENG(data-value)─┘

Conditions: FUNCERR, INVREQ, SELNERR, UNEXPIN

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

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

44

CICS User’s Handbook

API syntax

ISSUE REPLACE
──ISSUE REPLACE──DESTID(data-value)──┬────────────────────────┬────────── └─DESTIDLENG(data-value)─┘ ──┬────────────────────────────────────────────────┬──FROM(data-area)───── └─VOLUME(data-value)──┬────────────────────────┬─┘ └─VOLUMELENG(data-value)─┘ ──┬────────────────────┬──┬────────────────────┬──RIDFLD(data-area)─────── └─LENGTH(data-value)─┘ └─NUMREC(data-value)─┘ ──┬─KEYLENGTH(data-value)──┬───────────────────────┬─┬───┬─────────┬────── │ └─KEYNUMBER(data-value)─┘ │ └─DEFRESP─┘ └─RRN──────────────────────────────────────────────┘ ───┬────────┬─── └─NOWAIT─┘

Conditions: FUNCERR, INVREQ, SELNERR, UNEXPIN

ISSUE RESET
──ISSUE RESET──

Condition: INVREQ, NOTALLOC

ISSUE SEND
──ISSUE SEND──┬────────────────────────────────────────────────┬───────── ├─DESTID(data-value)──┬────────────────────────┬─┤ │ └─DESTIDLENG(data-value)─┘ │ │ ┌─CONSOLE──┐ │ └─SUBADDR(data-value)──┼──────────┼──────────────┘ ├─PRINT────┤ ├─CARD─────┤ ├─WPMEDIA1─┤ ├─WPMEDIA2─┤ ├─WPMEDIA3─┤ └─WPMEDIA4─┘ ──┬────────────────────────────────────────────────┬──FROM(data-area)───── └─VOLUME(data-value)──┬────────────────────────┬─┘ └─VOLUMELENG(data-value)─┘ ──┬────────────────────┬───┬────────┬────┬─────────┬─── └─LENGTH(data-value)─┘ └─NOWAIT─┘ └─DEFRESP─┘

Conditions: FUNCERR, IGREQCD, INVREQ, SELNERR, UNEXPIN

Chapter 1. Command-level application programming

45

API syntax

ISSUE SIGNAL (APPC)
? ──ISSUE SIGNAL──┬──────────────┬──┬─────────────┬── └─CONVID(name)─┘ └─STATE(cvda)─┘

?

Conditions: INVREQ, NOTALLOC, TERMERR

ISSUE SIGNAL (LUTYPE6.1)
──ISSUE SIGNAL──┬───────────────┬── ├─CONVID(name)──┤ └─SESSION(name)─┘

Conditions: NOTALLOC, TERMERR

ISSUE WAIT
──ISSUE WAIT──┬────────────────────────────────────────────────┬───────── ├─DESTID(data-value)──┬────────────────────────┬─┤ │ └─DESTIDLENG(data-value)─┘ │ │ ┌─CONSOLE──┐ │ └─SUBADDR(data-value)──┼──────────┼──────────────┘ ├─PRINT────┤ ├─CARD─────┤ ├─WPMEDIA1─┤ ├─WPMEDIA2─┤ ├─WPMEDIA3─┤ └─WPMEDIA4─┘ ──┬────────────────────────────────────────────────┬── └─VOLUME(data-value)──┬────────────────────────┬─┘ └─VOLUMELENG(data-value)─┘

Conditions: FUNCERR, INVREQ, SELNERR, UNEXPIN

46

CICS User’s Handbook

API syntax

LINK
──LINK──PROGRAM(name)──┬──────────────────────────────────┬────────────── └─COMMAREA(data-area)──┤ lengths ├─┘ ──┬─┬───────────────────┬──┬──────────────┬──┬───────────────┬─┬── │ └─SYSID(systemname)─┘ └─SYNCONRETURN─┘ └─TRANSID(name)─┘ │ └─INPUTMSG(data-area)──┬─────────────────────────┬───────────┘ └─INPUTMSGLEN(data-value)─┘ lengths: ├──┬────────────────────┬──┬───────────────────────┬──┤ └─LENGTH(data-value)─┘ └─DATALENGTH(data-area)─┘

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

LOAD
──LOAD──PROGRAM(name)──┬──────────────┬──┬────────────────────┬────────── └─SET(ptr-ref)─┘ ├─LENGTH(data-area)──┤ └─FLENGTH(data-area)─┘ ──┬────────────────┬───┬──────┬─── └─ENTRY(ptr-ref)─┘ └─HOLD─┘

Conditions: INVREQ, LENGERR, NOTAUTH, PGMIDERR

MONITOR
──MONITOR──POINT(data-value)──┬──────────────────┬─────────────────────── └─DATA1(data-area)─┘ ──┬──────────────────┬──┬──────────────────────┬── └─DATA2(data-area)─┘ └─ENTRYNAME(data-area)─┘

Condition: INVREQ

Chapter 1. Command-level application programming

47

API syntax

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

Condition: NOTALLOC

POP HANDLE
──POP HANDLE──

Condition: INVREQ

POST
┌─INTERVAL( )──────────────────────┐ ──POST──┼──────────────────────────────────┼──SET(ptr-ref)─────────────── ├─INTERVAL(hhmmss)─────────────────┤ ├─TIME(hhmmss)─────────────────────┤ │ ┌── ───────────────────────┐ │ ├─AFTER───┬─HOURS(data-value)───┬┴─┤ │ ├─MINUTES(data-value)─┤ │ │ └─SECONDS(data-value)─┘ │ │ ┌── ───────────────────────┐ │ └─AT───┬─HOURS(data-value)───┬┴────┘ ├─MINUTES(data-value)─┤ └─SECONDS(data-value)─┘ ──┬─────────────┬── └─REQID(name)─┘

Conditions: EXPIRED, INVREQ

PURGE MESSAGE
──PURGE MESSAGE──

Conditions: Full BMS: INVREQ, TSIOERR

48

CICS User’s Handbook

API syntax

PUSH HANDLE
──PUSH HANDLE──

QUERY SECURITY
──QUERY SECURITY──┬─RESTYPE(data-value)───────────────────────────┬────── └─RESCLASS(data-value)──RESIDLENGTH(data-value)─┘ ──RESID(data-value)──┬──────────────────┬──┬────────────┬───────────────── └─LOGMESSAGE(cvda)─┘ └─READ(cvda)─┘ ──┬──────────────┬──┬───────────────┬──┬─────────────┬── └─UPDATE(cvda)─┘ └─CONTROL(cvda)─┘ └─ALTER(cvda)─┘

Conditions: INVREQ, LENGERR, NOTFND, QIDERR

READ
┌─UNCOMMITTED──────────────────┐ ──READ──FILE(filename)──┼──────────────────────────────┼───────────────── ├─CONSISTENT───────────────────┤ ├─REPEATABLE───────────────────┤ └─UPDATE──┬──────────────────┬─┘ └─TOKEN(data-area)─┘ ──┬─INTO(data-area)─┬──┬───────────────────┬──RIDFLD(data-area)─────────── └─SET(ptr-ref)────┘ └─LENGTH(data-area)─┘ ──┬────────────────────────────────────┬──┬───────────────────┬─────────── └─KEYLENGTH(data-value)──┬─────────┬─┘ └─SYSID(systemname)─┘ └─GENERIC─┘ ┌─EQUAL─┐ ──┬────────┬──┼───────┼──┬───────────┬── ├─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
──READNEXT──FILE(filename)──┬─INTO(data-area)─┬────────────────────────── └─SET(ptr-ref)────┘ ┌─UNCOMMITTED──────────────┐ ──┼──────────────────────────┼──┬───────────────────┬───────────────────── ├─CONSISTENT───────────────┤ └─LENGTH(data-area)─┘ ├─REPEATABLE───────────────┤ └─UPDATE──TOKEN(data-area)─┘ ──RIDFLD(data-area)──┬───────────────────────┬──┬───────────────────┬───── └─KEYLENGTH(data-value)─┘ └─REQID(data-value)─┘ ──┬───────────────────┬──┬─────┬──┬───────────┬── └─SYSID(systemname)─┘ ├─RBA─┤ └─NOSUSPEND─┘ └─RRN─┘

|

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

READPREV
──READPREV──FILE(filename)──┬─INTO(data-area)─┬────────────────────────── └─SET(ptr-ref)────┘ ┌─UNCOMMITTED──────────────┐ ──┼──────────────────────────┼──┬───────────────────┬───────────────────── ├─CONSISTENT───────────────┤ └─LENGTH(data-area)─┘ ├─REPEATABLE───────────────┤ └─UPDATE──TOKEN(data-area)─┘ ──RIDFLD(data-area)──┬───────────────────────┬──┬───────────────────┬───── └─KEYLENGTH(data-value)─┘ └─REQID(data-value)─┘ ──┬───────────────────┬──┬─────┬──┬───────────┬── └─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
──READQ TD──QUEUE(name)──┬─INTO(data-area)─┬──┬───────────────────┬────── └─SET(ptr-ref)────┘ └─LENGTH(data-area)─┘ ──┬───────────────────┬───┬───────────┬─── └─SYSID(systemname)─┘ └─NOSUSPEND─┘

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

READQ TS
──READQ TS──┬─QUEUE(name)─┬──┬─INTO(data-area)─┬───────────────────────── └─QNAME(name)─┘ └─SET(ptr-ref)────┘ ┌─NEXT─────────────┐ ──┬───────────────────┬──┬─────────────────────┬──┼──────────────────┼──── └─LENGTH(data-area)─┘ └─NUMITEMS(data-area)─┘ └─ITEM(data-value)─┘ ──┬───────────────────┬── └─SYSID(systemname)─┘

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

RECEIVE (APPC)
──RECEIVE──┬──────────────┬──┬─INTO(data-area)─┬───────────────────────── └─CONVID(name)─┘ └─SET(ptr-ref)────┘ ──┬─LENGTH(data-area)──┬──┬────────────────────────┬───┬────────────┬───── └─FLENGTH(data-area)─┘ ├─MAXLENGTH(data-value)──┤ └─NOTRUNCATE─┘ └─MAXFLENGTH(data-value)─┘ ? ──┬─────────────┬── └─STATE(cvda)─┘

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

Chapter 1. Command-level application programming

51

API syntax

RECEIVE (default)
──RECEIVE──┬─────────────────┬─────────────────────────────────────────── ├─INTO(data-area)─┤ └─SET(ptr-ref)────┘ ──LENGTH(data-value)──FLENGTH(data-value)──┬──────────────────────┬─────── └─MAXLENGTH(data-area)─┘ ──NOTRUNCATE──

Conditions: INVREQ, LENGERR, NOTALLOC

RECEIVE (LUTYPE2/LUTYPE3)
──RECEIVE──┬─────────────────────┬──┬─LENGTH(data-area)──┬─────────────── └─┬─INTO(data-area)─┬─┘ └─FLENGTH(data-area)─┘ └─SET(ptr-ref)────┘ ──┬────────────────────────┬───┬──────┬────┬────────┬───────────────────── ├─MAXLENGTH(data-value)──┤ └─ASIS─┘ └─BUFFER─┘ └─MAXFLENGTH(data-value)─┘ ───┬────────────┬─── └─NOTRUNCATE─┘

Conditions: EOC, INVREQ, LENGERR, TERMERR

RECEIVE (LUTYPE4)
──RECEIVE──┬─────────────────────┬──┬─LENGTH(data-area)──┬─────────────── └─┬─INTO(data-area)─┬─┘ └─FLENGTH(data-area)─┘ └─SET(ptr-ref)────┘ ──┬────────────────────────┬───┬────────────┬─── ├─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)
──RECEIVE──┬───────────────┬──┬─INTO(data-area)─┬──────────────────────── └─SESSION(name)─┘ └─SET(ptr-ref)────┘ ──┬─LENGTH(data-area)──┬──┬────────────────────────┬───┬────────────┬─── └─FLENGTH(data-area)─┘ ├─MAXLENGTH(data-value)──┤ └─NOTRUNCATE─┘ └─MAXFLENGTH(data-value)─┘

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

RECEIVE (MRO)
──RECEIVE──┬───────────────┬──┬─INTO(data-area)─┬──────────────────────── └─SESSION(name)─┘ └─SET(ptr-ref)────┘ ──┬─LENGTH(data-area)──┬──┬────────────────────────┬───┬────────────┬───── └─FLENGTH(data-area)─┘ ├─MAXLENGTH(data-value)──┤ └─NOTRUNCATE─┘ └─MAXFLENGTH(data-value)─┘ ? ──┬─────────────┬── └─STATE(cvda)─┘

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

RECEIVE (System/3)
──RECEIVE──┬─────────────────────┬──┬─LENGTH(data-area)──┬─────────────── └─┬─INTO(data-area)─┬─┘ └─FLENGTH(data-area)─┘ └─SET(ptr-ref)────┘ ──┬────────────────────────┬───┬────────────┬────┬──────┬─── ├─MAXLENGTH(data-value)──┤ └─NOTRUNCATE─┘ └─ASIS─┘ └─MAXFLENGTH(data-value)─┘

Conditions: INVREQ, LENGERR

Chapter 1. Command-level application programming

53

API syntax

RECEIVE (System/7)
──RECEIVE──┬─────────────────────┬──┬─LENGTH(data-area)──┬─────────────── └─┬─INTO(data-area)─┬─┘ └─FLENGTH(data-area)─┘ └─SET(ptr-ref)────┘ ───┬───────────┬────┬──────┬─── └─PSEUDOBIN─┘ └─ASIS─┘

Conditions: INVREQ, LENGERR

RECEIVE (2260)
──RECEIVE──┬─────────────────────┬──┬─LENGTH(data-area)──┬─────────────── └─┬─INTO(data-area)─┬─┘ └─FLENGTH(data-area)─┘ └─SET(ptr-ref)────┘ ──┬────────────────────────┬───┬────────────┬────┬─────────┬─── ├─MAXLENGTH(data-value)──┤ └─NOTRUNCATE─┘ └─LEAVEKB─┘ └─MAXFLENGTH(data-value)─┘

Conditions: INVREQ, LENGERR

RECEIVE (2741)
──RECEIVE──┬─────────────────────┬──┬─LENGTH(data-area)──┬─────────────── └─┬─INTO(data-area)─┬─┘ └─FLENGTH(data-area)─┘ └─SET(ptr-ref)────┘ ──┬────────────────────────┬───┬────────────┬─── ├─MAXLENGTH(data-value)──┤ └─NOTRUNCATE─┘ └─MAXFLENGTH(data-value)─┘

Conditions: INVREQ, LENGERR, RDATT

54

CICS User’s Handbook

API syntax

RECEIVE (2980)
──RECEIVE──┬─────────────────────┬──┬─LENGTH(data-area)──┬─────────────── └─┬─INTO(data-area)─┬─┘ └─FLENGTH(data-area)─┘ └─SET(ptr-ref)────┘ ──┬────────────────────────┬───┬────────────┬───PASSBK── ├─MAXLENGTH(data-value)──┤ └─NOTRUNCATE─┘ └─MAXFLENGTH(data-value)─┘

Conditions: INVREQ, LENGERR, NOPASSBKRD

RECEIVE (3270 display)
──RECEIVE──┬─────────────────────┬──┬─LENGTH(data-area)──┬─────────────── └─┬─INTO(data-area)─┬─┘ └─FLENGTH(data-area)─┘ └─SET(ptr-ref)────┘ ──┬────────────────────────┬───┬────────────┬────┬──────┬───────────────── ├─MAXLENGTH(data-value)──┤ └─NOTRUNCATE─┘ └─ASIS─┘ └─MAXFLENGTH(data-value)─┘ ───┬────────┬─── └─BUFFER─┘

Conditions: INVREQ, LENGERR

RECEIVE (3270 logical)
──RECEIVE──┬─────────────────────┬──┬─LENGTH(data-area)──┬─────────────── └─┬─INTO(data-area)─┬─┘ └─FLENGTH(data-area)─┘ └─SET(ptr-ref)────┘ ──┬────────────────────────┬───┬──────┬────┬────────┬───────────────────── ├─MAXLENGTH(data-value)──┤ └─ASIS─┘ └─BUFFER─┘ └─MAXFLENGTH(data-value)─┘ ───┬────────────┬─── └─NOTRUNCATE─┘

Conditions: INVREQ, LENGERR, TERMERR

Chapter 1. Command-level application programming

55

API syntax

RECEIVE (3600 BTAM)
──RECEIVE──┬─────────────────────┬──┬─LENGTH(data-area)──┬─────────────── └─┬─INTO(data-area)─┬─┘ └─FLENGTH(data-area)─┘ └─SET(ptr-ref)────┘ ──┬────────────────────────┬───┬────────────┬─── ├─MAXLENGTH(data-value)──┤ └─NOTRUNCATE─┘ └─MAXFLENGTH(data-value)─┘

Conditions: INVREQ, LENGERR

RECEIVE (3600 pipeline)
──RECEIVE──┬─────────────────────┬──┬─LENGTH(data-area)──┬─────────────── └─┬─INTO(data-area)─┬─┘ └─FLENGTH(data-area)─┘ └─SET(ptr-ref)────┘ ──┬────────────────────────┬───┬────────────┬─── ├─MAXLENGTH(data-value)──┤ └─NOTRUNCATE─┘ └─MAXFLENGTH(data-value)─┘

Conditions: INVREQ, LENGERR, NOTALLOC

RECEIVE (3600-3601)
──RECEIVE──┬─────────────────────┬──┬─LENGTH(data-area)──┬─────────────── └─┬─INTO(data-area)─┬─┘ └─FLENGTH(data-area)─┘ └─SET(ptr-ref)────┘ ──┬────────────────────────┬───┬────────────┬─── ├─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)
──RECEIVE──┬─────────────────────┬──┬─LENGTH(data-area)──┬─────────────── └─┬─INTO(data-area)─┬─┘ └─FLENGTH(data-area)─┘ └─SET(ptr-ref)────┘ ──┬────────────────────────┬───┬────────────┬─── ├─MAXLENGTH(data-value)──┤ └─NOTRUNCATE─┘ └─MAXFLENGTH(data-value)─┘

Conditions: INVREQ, LENGERR, TERMERR

RECEIVE (3650)
──RECEIVE──┬─────────────────────┬──┬─LENGTH(data-area)──┬─────────────── └─┬─INTO(data-area)─┬─┘ └─FLENGTH(data-area)─┘ └─SET(ptr-ref)────┘ ──┬────────────────────────┬───┬────────────┬─── ├─MAXLENGTH(data-value)──┤ └─NOTRUNCATE─┘ └─MAXFLENGTH(data-value)─┘

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

RECEIVE (3735)
──RECEIVE──┬─────────────────────┬──┬─LENGTH(data-area)──┬─────────────── └─┬─INTO(data-area)─┬─┘ └─FLENGTH(data-area)─┘ └─SET(ptr-ref)────┘ ──┬────────────────────────┬───┬────────────┬─── ├─MAXLENGTH(data-value)──┤ └─NOTRUNCATE─┘ └─MAXFLENGTH(data-value)─┘

Conditions: EOF, INVREQ, LENGERR

Chapter 1. Command-level application programming

57

API syntax

RECEIVE (3740)
──RECEIVE──┬─────────────────────┬──┬─LENGTH(data-area)──┬─────────────── └─┬─INTO(data-area)─┬─┘ └─FLENGTH(data-area)─┘ └─SET(ptr-ref)────┘ ──┬────────────────────────┬───┬────────────┬─── ├─MAXLENGTH(data-value)──┤ └─NOTRUNCATE─┘ └─MAXFLENGTH(data-value)─┘

Conditions: EOF, ENDINPT, INVREQ, LENGERR

RECEIVE (3767)
──RECEIVE──┬─────────────────────┬──┬─LENGTH(data-area)──┬─────────────── └─┬─INTO(data-area)─┬─┘ └─FLENGTH(data-area)─┘ └─SET(ptr-ref)────┘ ──┬────────────────────────┬───┬────────────┬─── ├─MAXLENGTH(data-value)──┤ └─NOTRUNCATE─┘ └─MAXFLENGTH(data-value)─┘

Conditions: EOC, INVREQ, LENGERR, SIGNAL, TERMERR

RECEIVE (3770)
──RECEIVE──┬─────────────────────┬──┬─LENGTH(data-area)──┬─────────────── └─┬─INTO(data-area)─┬─┘ └─FLENGTH(data-area)─┘ └─SET(ptr-ref)────┘ ──┬────────────────────────┬───┬────────────┬─── ├─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)
──RECEIVE──┬─────────────────────┬──┬─LENGTH(data-area)──┬─────────────── └─┬─INTO(data-area)─┬─┘ └─FLENGTH(data-area)─┘ └─SET(ptr-ref)────┘ ──┬────────────────────────┬───┬────────────┬─── ├─MAXLENGTH(data-value)──┤ └─NOTRUNCATE─┘ └─MAXFLENGTH(data-value)─┘

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

RECEIVE (3790 3270-display)
──RECEIVE──┬─────────────────────┬──┬─LENGTH(data-area)──┬─────────────── └─┬─INTO(data-area)─┬─┘ └─FLENGTH(data-area)─┘ └─SET(ptr-ref)────┘ ──┬────────────────────────┬───┬──────┬────┬────────┬───────────────────── ├─MAXLENGTH(data-value)──┤ └─ASIS─┘ └─BUFFER─┘ └─MAXFLENGTH(data-value)─┘ ───┬────────────┬─── └─NOTRUNCATE─┘

Conditions: INVREQ, LENGERR, TERMERR

Chapter 1. Command-level application programming

59

API syntax

RECEIVE MAP
──RECEIVE MAP(name)──┬──────────────┬──┬─────────────────┬─────────────── └─MAPSET(name)─┘ ├─INTO(data-area)─┤ └─SET(ptr-ref)────┘ ┌─TERMINAL────────────────────────────────┐ ──┼─────────────────────────────────────────┼── ├─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
──RECEIVE MAP(name)──MAPPINGDEV(data-value)──FROM(data-area)───────────── ──┬────────────────────┬──┬──────────────┬──┬─────────────────┬── └─LENGTH(data-value)─┘ └─MAPSET(name)─┘ ├─INTO(data-area)─┤ └─SET(ptr-ref)────┘

Conditions: INVMPSZ, INVREQ, MAPFAIL,

RECEIVE PARTN
──RECEIVE PARTN(data-area)──

Standard and full BMS:

RECEIVE PARTN
──┬─INTO(data-area)─┬──LENGTH(data-value)───┬──────┬─── └─SET(ptr-ref)────┘ └─ASIS─┘

Conditions: EOC, EODS, INVPARTN, INVREQ, LENGERR

60

CICS User’s Handbook

API syntax

RELEASE
──RELEASE──PROGRAM(name)──

Conditions: INVREQ, NOTAUTH, PGMIDERR

RESETBR
──RESETBR──FILE(filename)──RIDFLD(data-area)───────────────────────────── ──┬────────────────────────────────────┬──┬───────────────────┬─────────── └─KEYLENGTH(data-value)──┬─────────┬─┘ └─REQID(data-value)─┘ └─GENERIC─┘ ┌─GTEQ──┐ ──┬───────────────────┬──┼───────┼──┬─────┬── └─SYSID(systemname)─┘ └─EQUAL─┘ ├─RBA─┤ └─RRN─┘

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

RETRIEVE
──RETRIEVE──┬─INTO(data-area)─┬──┬───────────────────┬─────────────────── └─SET(ptr-ref)────┘ └─LENGTH(data-area)─┘ ──┬─────────────────────┬──┬────────────────────┬───────────────────────── └─RTRANSID(data-area)─┘ └─RTERMID(data-area)─┘ ──┬──────────────────┬───┬──────┬─── └─QUEUE(data-area)─┘ └─WAIT─┘

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

Chapter 1. Command-level application programming

61

API syntax

RETURN
──RETURN──┬────────────────────────────────────────────────┬───────────── └─TRANSID(name)──┬──────────────┬──┬───────────┬─┘ └─┤ commarea ├─┘ └─IMMEDIATE─┘ ──┬──────────────────────────────────────────────────┬──────────────────── └─INPUTMSG(data-area)──┬─────────────────────────┬─┘ └─INPUTMSGLEN(data-value)─┘ | ──┬─────────────┬── └─ENDACTIVITY─┘ commarea: ├──COMMAREA(data-area)──┬────────────────────┬──┤ └─LENGTH(data-value)─┘

Conditions: INVREQ, LENGERR

REWRITE
──REWRITE──FILE(filename)──┬──────────────────┬──FROM(data-area)───────── └─TOKEN(data-area)─┘ ──┬────────────────────┬──┬───────────────────┬───┬───────────┬─── └─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( )──────────────────────┐ ──ROUTE──┼──────────────────────────────────┼──┬─────────────────────┬─── ├─INTERVAL(hhmmss)─────────────────┤ └─ERRTERM──┬────────┬─┘ ├─TIME(hhmmss)─────────────────────┤ └─(name)─┘ │ ┌── ───────────────────────┐ │ ├─AFTER───┬─HOURS(data-value)───┬┴─┤ │ ├─MINUTES(data-value)─┤ │ │ └─SECONDS(data-value)─┘ │ │ ┌── ───────────────────────┐ │ └─AT───┬─HOURS(data-value)───┬┴────┘ ├─MINUTES(data-value)─┤ └─SECONDS(data-value)─┘ ──┬──────────────────┬──┬─────────────────┬──┬────────────────────┬─────── └─TITLE(data-area)─┘ └─LIST(data-area)─┘ └─OPCLASS(data-area)─┘ ──┬─────────────┬──┬───────────┬───┬───────┬─── └─REQID(name)─┘ └─LDC(name)─┘ └─NLEOM─┘

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

SEND (APPC)
──SEND──┬──────────────┬──┬──────────────────────────────────────────┬─── └─CONVID(name)─┘ └─FROM(data-area)──┬─LENGTH(data-value)──┬─┘ └─FLENGTH(data-value)─┘ ? ──┬────────┬──┬─────────┬──┬─────────────┬── ├─INVITE─┤ ├─CONFIRM─┤ └─STATE(cvda)─┘ └─LAST───┘ └─WAIT────┘

Conditions: INVREQ, LENGERR, NOTALLOC, SIGNAL, TERMERR

SEND (default)
──SEND──FROM(data-area)──┬─LENGTH(data-value)──┬──┬────────────┬───────── └─FLENGTH(data-value)─┘ └─DEST(name)─┘ ───┬──────┬─── └─WAIT─┘

Conditions: INVREQ, LENGERR, NOTALLOC

Chapter 1. Command-level application programming

63

API syntax

SEND (LUTYPE2/LUTYPE3)
──SEND──FROM(data-area)──┬─LENGTH(data-value)──┬───┬──────┬────────────── └─FLENGTH(data-value)─┘ └─WAIT─┘ ──┬────────┬──┬─┬──────────────────────┬──┬─────────────────────┬─┬─────── ├─INVITE─┤ │ └─ERASE──┬───────────┬─┘ └─CTLCHAR(data-value)─┘ │ └─LAST───┘ │ ├─DEFAULT───┤ │ │ └─ALTERNATE─┘ │ └─STRFIELD──────────────────────────────────────────┘ ───┬─────────┬─── └─DEFRESP─┘

Conditions: INVREQ, LENGERR, TERMERR

SEND (LUTYPE4)
──SEND──FROM(data-area)──┬─LENGTH(data-value)──┬───┬──────┬────────────── └─FLENGTH(data-value)─┘ └─WAIT─┘ ──┬────────┬──┬───────────┬───┬─────┬─── ├─INVITE─┤ ├─CNOTCOMPL─┤ └─FMH─┘ └─LAST───┘ └─DEFRESP───┘

Conditions: INVREQ, IGREQCD, LENGERR, SIGNAL, TERMERR

SEND (LUTYPE6.1)
──SEND──┬───────────────┬───┬──────┬───┬────────┬──┬────────────────┬──── └─SESSION(name)─┘ └─WAIT─┘ ├─INVITE─┤ └─ATTACHID(name)─┘ └─LAST───┘ ──┬─────────────────┬──┬─────────────────────┬───┬─────┬────────────────── └─FROM(data-area)─┘ ├─LENGTH(data-value)──┤ └─FMH─┘ └─FLENGTH(data-value)─┘ ───┬─────────┬─── └─DEFRESP─┘

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

64

CICS User’s Handbook

API syntax

SEND (MRO)
──SEND──┬───────────────┬───┬──────┬───┬────────┬──┬────────────────┬──── └─SESSION(name)─┘ └─WAIT─┘ ├─INVITE─┤ └─ATTACHID(name)─┘ └─LAST───┘ ──┬─────────────────┬──┬─────────────────────┬───┬─────┬────────────────── └─FROM(data-area)─┘ ├─LENGTH(data-value)──┤ └─FMH─┘ └─FLENGTH(data-value)─┘ ? ───┬─────────┬───┬─────────────┬── └─DEFRESP─┘ └─STATE(cvda)─┘

Conditions: CBIDERR, INVREQ, LENGERR, NOTALLOC, TERMERR

SEND (SCS)
──SEND──FROM(data-area)──┬─LENGTH(data-value)──┬───┬──────┬────────────── └─FLENGTH(data-value)─┘ └─WAIT─┘ ──┬────────┬──┬───────────┬───┬──────────┬────┬─────┬─── ├─INVITE─┤ ├─CNOTCOMPL─┤ └─STRFIELD─┘ └─FMH─┘ └─LAST───┘ └─DEFRESP───┘

Conditions: INVREQ, LENGERR, TERMERR

SEND (System/3)
──SEND──FROM(data-area)──┬─LENGTH(data-value)──┬──┬────────────┬───────── └─FLENGTH(data-value)─┘ └─DEST(name)─┘ ───┬──────┬────┬──────┬────┬───────────┬─── └─WAIT─┘ └─ASIS─┘ └─CNOTCOMPL─┘

Conditions: INVREQ, LENGERR

SEND (System/7)
──SEND──FROM(data-area)──┬─LENGTH(data-value)──┬──┬────────────┬───────── └─FLENGTH(data-value)─┘ └─DEST(name)─┘ ───┬──────┬────┬───────────┬────┬──────┬─── └─WAIT─┘ └─PSEUDOBIN─┘ └─ASIS─┘

Conditions: INVREQ, LENGERR

Chapter 1. Command-level application programming

65

API syntax

SEND (2260)
──SEND──FROM(data-area)──┬─LENGTH(data-value)──┬───────────────────────── └─FLENGTH(data-value)─┘ ──┬─────────────────────┬──┬────────────┬──┬──────────────────────┬─────── └─CTLCHAR(data-value)─┘ └─DEST(name)─┘ └─LINEADDR(data-value)─┘ ───┬──────┬────┬─────────┬─── └─WAIT─┘ └─LEAVEKB─┘

Conditions: INVREQ, LENGERR

SEND (2741)
──SEND──FROM(data-area)──┬─LENGTH(data-value)──┬──┬────────────┬───────── └─FLENGTH(data-value)─┘ └─DEST(name)─┘ ───┬──────┬─── └─WAIT─┘

Conditions: INVREQ, LENGERR, WRBRK

SEND (2980)
──SEND──FROM(data-area)──┬─LENGTH(data-value)──┬──┬────────────┬───────── └─FLENGTH(data-value)─┘ └─DEST(name)─┘ ──┬─PASSBK─┬── └─CBUFF──┘

Conditions: INVREQ, LENGERR, NOPASSBKWR

SEND (3270 display)
──SEND──FROM(data-area)──┬─LENGTH(data-value)──┬──┬────────────┬───────── └─FLENGTH(data-value)─┘ └─DEST(name)─┘ ───┬──────┬───┬─┬──────────────────────┬──┬─────────────────────┬─┬── └─WAIT─┘ │ └─ERASE──┬───────────┬─┘ └─CTLCHAR(data-value)─┘ │ │ ├─DEFAULT───┤ │ │ └─ALTERNATE─┘ │ └─STRFIELD──────────────────────────────────────────┘

Conditions: INVREQ, LENGERR

66

CICS User’s Handbook

API syntax

SEND (3270 logical)
──SEND──FROM(data-area)──┬─LENGTH(data-value)──┬───┬──────┬────────────── └─FLENGTH(data-value)─┘ └─WAIT─┘ ──┬────────┬──┬─┬──────────────────────┬──┬─────────────────────┬─┬─────── ├─INVITE─┤ │ └─ERASE──┬───────────┬─┘ └─CTLCHAR(data-value)─┘ │ └─LAST───┘ │ ├─DEFAULT───┤ │ │ └─ALTERNATE─┘ │ └─STRFIELD──────────────────────────────────────────┘ ───┬─────────┬─── └─DEFRESP─┘

Conditions: INVREQ, LENGERR, TERMERR

SEND (3600 BTAM)
──SEND──FROM(data-area)──┬─LENGTH(data-value)──┬───┬──────┬────────────── └─FLENGTH(data-value)─┘ └─WAIT─┘ ───┬──────┬─── └─ASIS─┘

Conditions: INVREQ, LENGERR

SEND (3600 pipeline)
──SEND──FROM(data-area)──┬─LENGTH(data-value)──┬───┬──────┬─── └─FLENGTH(data-value)─┘ └─WAIT─┘

Conditions: INVREQ, LENGERR, TERMERR

SEND (3600-3601)
──SEND──FROM(data-area)──┬─LENGTH(data-value)──┬──┬───────────┬────────── └─FLENGTH(data-value)─┘ ├─LDC(name)─┤ └─FMH───────┘ ───┬──────┬───┬────────┬──┬───────────┬── └─WAIT─┘ ├─INVITE─┤ ├─CNOTCOMPL─┤ └─LAST───┘ └─DEFRESP───┘

Conditions: INVREQ, LENGERR, SIGNAL, TERMERR

Chapter 1. Command-level application programming

67

API syntax

SEND (3600-3614)
──SEND──FROM(data-area)──┬─LENGTH(data-value)──┬───┬──────┬────────────── └─FLENGTH(data-value)─┘ └─WAIT─┘ ──┬────────┬──┬───────────┬── ├─INVITE─┤ ├─CNOTCOMPL─┤ └─LAST───┘ └─DEFRESP───┘

Conditions: INVREQ, LENGERR, TERMERR

SEND (3650 interpreter)
──SEND──FROM(data-area)──┬─LENGTH(data-value)──┬───┬──────┬────────────── └─FLENGTH(data-value)─┘ └─WAIT─┘ ──┬────────┬───┬─────────┬────┬─────┬─── ├─INVITE─┤ └─DEFRESP─┘ └─FMH─┘ └─LAST───┘

Conditions: INVREQ, LENGERR, TERMERR

SEND (3650-3270)
──SEND──FROM(data-area)──┬─LENGTH(data-value)──┬───────────────────────── └─FLENGTH(data-value)─┘ ──┬─────────────────────┬───┬──────┬───┬──────────────────────┬─────────── └─CTLCHAR(data-value)─┘ └─WAIT─┘ └─ERASE──┬───────────┬─┘ ├─DEFAULT───┤ └─ALTERNATE─┘ ──┬────────┬──┬───────────┬───┬─────┬─── ├─INVITE─┤ ├─CNOTCOMPL─┤ └─FMH─┘ └─LAST───┘ └─DEFRESP───┘

Conditions: INVREQ, LENGERR, TERMERR

68

CICS User’s Handbook

API syntax

SEND (3650-3653)
──SEND──FROM(data-area)──┬─LENGTH(data-value)──┬───┬──────┬────────────── └─FLENGTH(data-value)─┘ └─WAIT─┘ ──┬────────┬──┬───────────┬── ├─INVITE─┤ ├─CNOTCOMPL─┤ └─LAST───┘ └─DEFRESP───┘

Conditions: INVREQ, LENGERR, TERMERR

SEND (3650-3680)
──SEND──FROM(data-area)──┬─LENGTH(data-value)──┬───┬──────┬────────────── └─FLENGTH(data-value)─┘ └─WAIT─┘ ──┬────────┬──┬───────────┬───┬─────┬─── ├─INVITE─┤ ├─CNOTCOMPL─┤ └─FMH─┘ └─LAST───┘ └─DEFRESP───┘

Conditions: INVREQ, LENGERR, TERMERR

SEND (3735)
──SEND──FROM(data-area)──┬─LENGTH(data-value)──┬───┬──────┬────────────── └─FLENGTH(data-value)─┘ └─WAIT─┘ ───┬──────┬─── └─ASIS─┘

Conditions: INVREQ, LENGERR

SEND (3740)
──SEND──FROM(data-area)──┬─LENGTH(data-value)──┬───┬──────┬────────────── └─FLENGTH(data-value)─┘ └─WAIT─┘ ───┬──────┬─── └─ASIS─┘

Conditions: INVREQ, LENGERR

Chapter 1. Command-level application programming

69

API syntax

SEND (3767)
──SEND──FROM(data-area)──┬─LENGTH(data-value)──┬───┬──────┬────────────── └─FLENGTH(data-value)─┘ └─WAIT─┘ ──┬────────┬──┬───────────┬── ├─INVITE─┤ ├─CNOTCOMPL─┤ └─LAST───┘ └─DEFRESP───┘

Conditions: INVREQ, LENGERR, SIGNAL, TERMERR

SEND (3770)
──SEND──FROM(data-area)──┬─LENGTH(data-value)──┬───┬──────┬────────────── └─FLENGTH(data-value)─┘ └─WAIT─┘ ──┬────────┬──┬───────────┬───┬─────┬─── ├─INVITE─┤ ├─CNOTCOMPL─┤ └─FMH─┘ └─LAST───┘ └─DEFRESP───┘

Conditions: INVREQ, LENGERR, SIGNAL, TERMERR

SEND (3790 full-function or inquiry)
──SEND──FROM(data-area)──┬─LENGTH(data-value)──┬───┬──────┬────────────── └─FLENGTH(data-value)─┘ └─WAIT─┘ ──┬────────┬──┬───────────┬───┬─────┬─── ├─INVITE─┤ ├─CNOTCOMPL─┤ └─FMH─┘ └─LAST───┘ └─DEFRESP───┘

Conditions: INVREQ, LENGERR, SIGNAL, TERMERR

SEND (3790 SCS)
──SEND──FROM(data-area)──┬─LENGTH(data-value)──┬───┬──────┬────────────── └─FLENGTH(data-value)─┘ └─WAIT─┘ ──┬────────┬──┬───────────┬── ├─INVITE─┤ ├─CNOTCOMPL─┤ └─LAST───┘ └─DEFRESP───┘

Conditions: INVREQ, LENGERR, TERMERR

70

CICS User’s Handbook

API syntax

SEND (3790 3270-display)
──SEND──FROM(data-area)──┬─LENGTH(data-value)──┬───────────────────────── └─FLENGTH(data-value)─┘ ──┬─────────────────────┬───┬──────┬───┬──────────────────────┬─────────── └─CTLCHAR(data-value)─┘ └─WAIT─┘ └─ERASE──┬───────────┬─┘ ├─DEFAULT───┤ └─ALTERNATE─┘ ──┬────────┬───┬─────────┬─── ├─INVITE─┤ └─DEFRESP─┘ └─LAST───┘

Conditions: INVREQ, LENGERR, TERMERR

SEND (3790 3270-printer)
──SEND──FROM(data-area)──┬─LENGTH(data-value)──┬───────────────────────── └─FLENGTH(data-value)─┘ ──┬─────────────────────┬───┬──────┬───┬──────────────────────┬─────────── └─CTLCHAR(data-value)─┘ └─WAIT─┘ └─ERASE──┬───────────┬─┘ ├─DEFAULT───┤ └─ALTERNATE─┘ ──┬────────┬───┬─────────┬─── ├─INVITE─┤ └─DEFRESP─┘ └─LAST───┘

Conditions: INVREQ, LENGERR, TERMERR

Chapter 1. Command-level application programming

71

API syntax

SEND CONTROL
──SEND CONTROL──

Minimum BMS:

SEND CONTROL
──┬──────────────────────────┬───┬──────────┬──────────────────────────── └─CURSOR──┬──────────────┬─┘ └─FORMFEED─┘ └─(data-value)─┘ ──┬──────────────────────┬───┬───────┬────┬────────┬────┬───────┬───────── ├─ERASE──┬───────────┬─┤ └─PRINT─┘ └─FREEKB─┘ └─ALARM─┘ │ ├─DEFAULT───┤ │ │ └─ALTERNATE─┘ │ └─ERASEAUP─────────────┘ ───┬───────┬─── └─FRSET─┘

Standard BMS:

SEND CONTROL
──┬─────────────────┬──┬─┬────────────────┬──┬────────────────┬─┬── └─MSR(data-value)─┘ │ └─OUTPARTN(name)─┘ └─ACTPARTN(name)─┘ │ └─LDC(name)──────────────────────────────┘

Full BMS:

72

CICS User’s Handbook

API syntax

SEND CONTROL
┌─TERMINAL─────────────────────┐ ───┬───────┬───┼──────────────────────────────┼──┬─────────────┬───────── └─ACCUM─┘ ├─SET(ptr-ref)─────────────────┤ └─REQID(name)─┘ ├─PAGING───────────────────────┤ └─TERMINAL──┬──────┬──┬──────┬─┘ └─WAIT─┘ └─LAST─┘ ┌─HONEOM─┐ ──┼────────┼── ├─L4 ────┤ ├─L64────┤ └─L8 ────┘

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

Chapter 1. Command-level application programming

73

API syntax

SEND MAP
──SEND MAP(name)──

Minimum BMS:

SEND MAP
──┬──────────────┬─────────────────────────────────────────────────────── └─MAPSET(name)─┘ ──┬─┬─────────────────┬──┬──────────┬──┬────────────────────┬─┬─────────── │ └─FROM(data-area)─┘ └─DATAONLY─┘ └─LENGTH(data-value)─┘ │ └─MAPONLY───────────────────────────────────────────────────┘ ──┬──────────────────────────┬───┬──────────┬───────────────────────────── └─CURSOR──┬──────────────┬─┘ └─FORMFEED─┘ └─(data-value)─┘ ──┬──────────────────────┬───┬───────┬────┬────────┬────┬───────┬───────── ├─ERASE──┬───────────┬─┤ └─PRINT─┘ └─FREEKB─┘ └─ALARM─┘ │ ├─DEFAULT───┤ │ │ └─ALTERNATE─┘ │ └─ERASEAUP─────────────┘ ───┬───────┬─── └─FRSET─┘

Standard BMS:

SEND MAP
───┬───────┬───┬─────────────────┬──┬───────────────┬──────────────────── └─NLEOM─┘ └─MSR(data-value)─┘ └─FMHPARM(name)─┘ ──┬─┬────────────────┬──┬────────────────┬─┬── │ └─OUTPARTN(name)─┘ └─ACTPARTN(name)─┘ │ └─LDC(name)──────────────────────────────┘

Full BMS:

74

CICS User’s Handbook

API syntax

SEND MAP
┌─TERMINAL─────────────────────┐ ───┬───────┬───┼──────────────────────────────┼──┬─────────────┬───────── └─ACCUM─┘ ├─SET(ptr-ref)─────────────────┤ └─REQID(name)─┘ ├─PAGING───────────────────────┤ └─TERMINAL──┬──────┬──┬──────┬─┘ └─WAIT─┘ └─LAST─┘ ┌─HONEOM─┐ ───┬─────────┬───┼────────┼── └─NOFLUSH─┘ ├─L4 ────┤ ├─L64────┤ └─L8 ────┘

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

SEND MAP
──SEND MAP(name)──MAPPINGDEV(data-value)──SET(ptr-ref)─────────────────── ──┬──────────────┬──────────────────────────────────────────────────────── └─MAPSET(name)─┘ ──┬─┬─────────────────┬──┬──────────┬──┬────────────────────┬─┬─────────── │ └─FROM(data-area)─┘ └─DATAONLY─┘ └─LENGTH(data-value)─┘ │ └─MAPONLY───────────────────────────────────────────────────┘ ──┬──────────────────────────┬───┬──────────┬───┬──────────┬────────────── └─CURSOR──┬──────────────┬─┘ └─FORMFEED─┘ ├─ERASE────┤ └─(data-value)─┘ └─ERASEAUP─┘ ───┬───────┬────┬────────┬────┬───────┬────┬───────┬─── └─PRINT─┘ └─FREEKB─┘ └─ALARM─┘ └─FRSET─┘

Conditions: INVMPSZ, INVREQ

Chapter 1. Command-level application programming

75

API syntax

SEND PAGE
──SEND PAGE──┬─RELEASE──┬───────────────┬─┬──┬────────────────────┬────── │ └─TRANSID(name)─┘ │ └─TRAILER(data-area)─┘ └─RETAIN─────────────────────┘ ──┬──────────────┬──┬───────────────────────┬───┬───────────┬───────────── └─SET(ptr-ref)─┘ ├─AUTOPAGE──┬─────────┬─┤ └─OPERPURGE─┘ │ ├─CURRENT─┤ │ │ └─ALL─────┘ │ └─NOAUTOPAGE────────────┘ ──┬───────────────┬───┬──────┬─── └─FMHPARM(name)─┘ └─LAST─┘

Conditions: IGREQCD, INVREQ, RETPAGE, TSIOERR, WRBRK

SEND PARTNSET
──SEND PARTNSET──┬────────┬── └─(name)─┘

Conditions: INVPARTNSET, INVREQ

SEND TEXT
──SEND TEXT──

Standard BMS:

SEND TEXT
──FROM(data-area)──┬────────────────────┬──┬────────────────────┬──────── └─LENGTH(data-value)─┘ └─CURSOR(data-value)─┘ ───┬──────────┬───┬──────────────────────┬───┬───────┬────┬────────┬────── └─FORMFEED─┘ └─ERASE──┬───────────┬─┘ └─PRINT─┘ └─FREEKB─┘ ├─DEFAULT───┤ └─ALTERNATE─┘ ───┬───────┬────┬───────┬───┬───────────────┬───────────────────────────── └─ALARM─┘ └─NLEOM─┘ └─FMHPARM(name)─┘ ──┬─┬────────────────┬──┬────────────────┬─┬──┬─────────────────┬── │ └─OUTPARTN(name)─┘ └─ACTPARTN(name)─┘ │ └─MSR(data-value)─┘ └─LDC(name)──────────────────────────────┘

76

CICS User’s Handbook

API syntax
Full BMS:

SEND TEXT
┌─TERMINAL─────────────────────┐ ──┼──────────────────────────────┼──┬─────────────┬────────────────────── ├─SET(ptr-ref)─────────────────┤ └─REQID(name)─┘ ├─PAGING───────────────────────┤ └─TERMINAL──┬──────┬──┬──────┬─┘ └─WAIT─┘ └─LAST─┘ ──┬───────────────────┬──┬────────────────────┬─────────────────────────── └─HEADER(data-area)─┘ └─TRAILER(data-area)─┘ ┌─HONEOM─┐ ──┬─────────────────────┬───┬───────┬───┼────────┼── ├─JUSTIFY(data-value)─┤ └─ACCUM─┘ ├─L4 ────┤ ├─JUSFIRST────────────┤ ├─L64────┤ └─JUSLAST─────────────┘ └─L8 ────┘

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

SEND TEXT MAPPED
──SEND TEXT MAPPED──FROM(data-area)──┬────────────────────┬────────────── └─LENGTH(data-value)─┘ ┌─TERMINAL─────────────────────┐ ──┼──────────────────────────────┼──┬─────────────┬── ├─PAGING───────────────────────┤ └─REQID(name)─┘ └─TERMINAL──┬──────┬──┬──────┬─┘ └─WAIT─┘ └─LAST─┘

Conditions: IGREQCD, IGREQID, INVREQ, TSIOERR, WRBRK

Chapter 1. Command-level application programming

77

API syntax

SEND TEXT NOEDIT
──SEND TEXT NOEDIT──FROM(data-area)──┬────────────────────┬────────────── └─LENGTH(data-value)─┘ ──┬──────────────────────┬───┬───────┬────┬────────┬────┬───────┬───────── └─ERASE──┬───────────┬─┘ └─PRINT─┘ └─FREEKB─┘ └─ALARM─┘ ├─DEFAULT───┤ └─ALTERNATE─┘ ┌─TERMINAL─────────────────────┐ ──┬────────────────┬──┼──────────────────────────────┼──────────────────── └─OUTPARTN(name)─┘ ├─TERMINAL──┬──────┬──┬──────┬─┤ │ └─WAIT─┘ └─LAST─┘ │ └─PAGING───────────────────────┘ ┌─HONEOM─┐ ──┬─────────────┬──┼────────┼── └─REQID(name)─┘ ├─L4 ────┤ ├─L64────┤ └─L8 ────┘

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

SIGNOFF
──SIGNOFF──

Condition: INVREQ

SIGNON
──SIGNON──USERID(data-value)──┬──────────────────────┬─────────────────── └─ESMREASON(data-area)─┘ ──┬────────────────────┬──┬─────────────────────┬───────────────────────── └─ESMRESP(data-area)─┘ └─GROUPID(data-value)─┘ ──┬──────────────────────────┬──┬──────────────────────┬────────────────── ├─LANGUAGECODE(data-value)─┤ └─LANGINUSE(data-area)─┘ └─NATLANG(data-value)──────┘ ──┬─────────────────────────┬──┬──────────────────────┬─────────────────── └─NATLANGINUSE(data-area)─┘ └─PASSWORD(data-value)─┘ ──┬─────────────────────────┬──┬─────────────────────┬── └─NEWPASSWORD(data-value)─┘ └─OIDCARD(data-value)─┘

Conditions: INVREQ, NOTAUTH, USERIDERR

78

CICS User’s Handbook

API syntax

SPOOLCLOSE TOKEN
┌── ───────────────────┐ ──SPOOLCLOSE──TOKEN(data-area)──┬────────┬───┬─NOHANDLE────────┬┴── ├─KEEP───┤ └─RESP──┬───────┬─┘ └─DELETE─┘ └─RESP2─┘

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

SPOOLOPEN INPUT
──SPOOLOPEN INPUT──TOKEN(data-area)──USERID(data-value)────────────────── ┌── ───────────────────┐ ──┬───────────────────┬───┬─NOHANDLE────────┬┴── └─CLASS(data-value)─┘ └─RESP──┬───────┬─┘ └─RESP2─┘

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

SPOOLOPEN OUTPUT
──SPOOLOPEN OUTPUT──TOKEN(data-area)──USERID(data-value)───────────────── ──NODE(data-value)──┬───────────────────┬──┬───────────────────┬────────── └─CLASS(data-value)─┘ └─OUTDESCR(ptr-ref)─┘ ┌─NOCC─┐ ┌─PRINT───────────────────────────────┐ ──┼──────┼──┼─────────────────────────────────────┼─────────────────────── ├─ASA──┤ ├─PRINT──┬──────────────────────────┬─┤ └─MCC──┘ │ └─RECORDLENGTH(data-value)─┘ │ └─PUNCH───────────────────────────────┘ ┌── ───────────────────┐ ───┬─NOHANDLE────────┬┴── └─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
──SPOOLREAD──TOKEN(data-area)──INTO(data-area)─────────────────────────── ──┬────────────────────────┬──┬──────────────────────┬──────────────────── └─MAXFLENGTH(data-value)─┘ └─TOFLENGTH(data-area)─┘ ┌── ───────────────────┐ ───┬─NOHANDLE────────┬┴── └─RESP──┬───────┬─┘ └─RESP2─┘

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

SPOOLWRITE
──SPOOLWRITE──TOKEN(data-area)──FROM(data-area)────────────────────────── ┌─LINE─┐ ┌── ───────────────────┐ ──┬─────────────────────┬──┼──────┼───┬─NOHANDLE────────┬┴── └─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( )──────────────────────┐ ──START──TRANSID(name)──┼──────────────────────────────────┼───────────── ├─INTERVAL(hhmmss)─────────────────┤ ├─TIME(hhmmss)─────────────────────┤ │ ┌── ───────────────────────┐ │ ├─AFTER───┬─HOURS(data-value)───┬┴─┤ │ ├─MINUTES(data-value)─┤ │ │ └─SECONDS(data-value)─┘ │ │ ┌── ───────────────────────┐ │ └─AT───┬─HOURS(data-value)───┬┴────┘ ├─MINUTES(data-value)─┤ └─SECONDS(data-value)─┘ ──┬─────────────┬──┬──────────────────────────────────────────────┬─────── └─REQID(name)─┘ └─FROM(data-area)──LENGTH(data-value)──┬─────┬─┘ └─FMH─┘ ──┬────────────────────┬──┬───────────────────┬──┬────────────────┬─────── ├─TERMID(name)───────┤ └─SYSID(systemname)─┘ └─RTRANSID(name)─┘ └─USERID(data-value)─┘ ──┬───────────────┬──┬─────────────┬───┬─────────┬────┬─────────┬─── └─RTERMID(name)─┘ └─QUEUE(name)─┘ └─NOCHECK─┘ └─PROTECT─┘

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

START ATTACH
──START ATTACH──TRANSID(name)──┬─────────────────────────────────────┬── └─FROM(data-area)──LENGTH(data-value)─┘

Conditions: INVREQ, LENGERR, NOTAUTH, TRANSIDERR

START BREXIT
──START──┬─BREXIT───────┬──TRANSID(name)───────────────────────────────── └─BREXIT(name)─┘ ──┬─────────────────────────────────────────────┬───────────────────────── └─BRDATA(data-area)──BRDATALENGTH(data-value)─┘ ──┬────────────────────┬── └─USERID(data-value)─┘

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

Chapter 1. Command-level application programming

81

API syntax

STARTBR
──STARTBR──FILE(filename)──RIDFLD(data-area)───────────────────────────── ──┬────────────────────────────────────┬──┬───────────────────┬─────────── └─KEYLENGTH(data-value)──┬─────────┬─┘ └─REQID(data-value)─┘ └─GENERIC─┘ ──┬───────────────────┬──┬────────┬──┬───────┬── └─SYSID(systemname)─┘ ├─RBA────┤ ├─GTEQ──┤ ├─RRN────┤ └─EQUAL─┘ ├─DEBKEY─┤ └─DEBREC─┘

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

SUSPEND
──SUSPEND──

SYNCPOINT
──SYNCPOINT──

Conditions: INVREQ, ROLLEDBACK

SYNCPOINT ROLLBACK
──SYNCPOINT──ROLLBACK──

Condition: INVREQ

82

CICS User’s Handbook

API syntax

EXTRACT TCPIP
──EXTRACT──TCPIP──┬───────────────────────────────────────────────┬────── └─CLIENTNAME(data-area)──CNAMELENGTH(data-area)─┘ ──┬───────────────────────────────────────────────┬─────────────────────── └─SERVERNAME(data-area)──SNAMELENGTH(data-area)─┘ ──┬─CLIENTADDR(data-area)──CADDRLENGTH(data-area)─┬──┬───────────────┬──── ├─CLIENTADDRNU(data-area)───────────────────────┤ └─SSLTYPE(cvda)─┘ ├─SERVERADDR(data-area)──SADDRLENGTH(data-area)─┤ └─SERVERADDRNU(data-area)───────────────────────┘ ──┬─────────────────────────┬──┬───────────────────────┬────────────────── └─TCPIPSERVICE(data-area)─┘ └─PORTNUMBER(data-area)─┘ ──┬──────────────────────┬── └─PORTNUMNU(data-area)─┘

Conditions: INVREQ, LENGERR

UNLOCK
──UNLOCK──FILE(filename)──┬──────────────────┬──┬───────────────────┬── └─TOKEN(data-area)─┘ └─SYSID(systemname)─┘

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

VERIFY PASSWORD
──VERIFY PASSWORD(data-value)──USERID(data-value)──────────────────────── ──┬───────────────────────┬──┬─────────────────────┬────────────────────── └─CHANGETIME(data-area)─┘ └─DAYSLEFT(data-area)─┘ ──┬──────────────────────┬──┬────────────────────┬──────────────────────── └─ESMREASON(data-area)─┘ └─ESMRESP(data-area)─┘ ──┬───────────────────────┬──┬─────────────────────────┬────────────────── └─EXPIRYTIME(data-area)─┘ └─INVALIDCOUNT(data-area)─┘ ──┬────────────────────────┬── └─LASTUSETIME(data-area)─┘

Conditions: INVREQ, NOTAUTH, USERIDERR

Chapter 1. Command-level application programming

83

API syntax

WAIT CONVID (APPC)
? ──WAIT CONVID(name)──┬─────────────┬── └─STATE(cvda)─┘

Conditions: INVREQ, NOTALLOC

WAIT EVENT
? ──WAIT EVENT──ECADDR(ptr-value)──┬────────────┬── └─NAME(name)─┘

Condition: INVREQ

WAIT EXTERNAL
──WAIT EXTERNAL──ECBLIST(ptr-value)──NUMEVENTS(data-value)─────────────── ┌─PURGEABLE──────────┐ ──┼────────────────────┼──┬────────────┬── ├─PURGEABILITY(cvda)─┤ └─NAME(name)─┘ └─NOTPURGEABLE───────┘

?

Condition: INVREQ

WAIT JOURNALNAME
──WAIT JOURNALNAME(data-value)──┬───────────────────┬── └─REQID(data-value)─┘

Conditions: INVREQ, IOERR, JIDERR, NOTOPEN

84

CICS User’s Handbook

API syntax

WAIT SIGNAL
──WAIT SIGNAL──

Conditions: NOTALLOC, SIGNAL, TERMERR

WAIT TERMINAL
──WAIT TERMINAL──┬───────────────┬── ├─CONVID(name)──┤ └─SESSION(name)─┘

Conditions: INVREQ, NOTALLOC, SIGNAL

WAITCICS
──WAITCICS──ECBLIST(ptr-value)──NUMEVENTS(data-value)──────────────────── ┌─PURGEABLE──────────┐ ──┼────────────────────┼──┬────────────┬── ├─PURGEABILITY(cvda)─┤ └─NAME(name)─┘ └─NOTPURGEABLE───────┘

?

Condition: INVREQ

WEB ENDBROWSE
──WEB──ENDBROWSE──HTTPHEADER──

Conditions: INVREQ

Chapter 1. Command-level application programming

85

API syntax

WEB EXTRACT
──WEB──EXTRACT──┬────────────────────────────────────────────────┬─────── └─HTTPMETHOD(data-area)──METHODLENGTH(data-area)─┘ ──┬───────────────────────────────────────────────┬─────────────────────── └─HTTPVERSION(data-area)──VERSIONLEN(data-area)─┘ ──┬────────────────────────────────────────┬──┬───────────────────┬── └─PATH(data-area)──PATHLENGTH(data-area)─┘ └─REQUESTTYPE(cvda)─┘

Conditions: INVREQ, LENGERR

WEB READ
──WEB──READ──HTTPHEADER(data-area)──NAMELENGTH(data-value)─────────────── ──VALUE(data-area)──VALUELENGTH(data-area)──

Conditions:INVREQ, LENGERR, NOTFND

WEB READNEXT
──WEB──READNEXT──HTTPHEADER(data-area)──NAMELENGTH(data-area)──────────── ──VALUE(data-area)──VALUELENGTH(data-area)──

Conditions:ENDFILE, INVREQ, LENGERR

WEB RECEIVE
──WEB──RECEIVE──┬─INTO(data-area)─┬──LENGTH(data-area)─────────────────── └─SET(ptr-ref)────┘ ──MAXLENGTH(data-value)──┬────────────┬──┬────────────┬─────────────────── └─TYPE(cvda)─┘ └─NOTRUNCATE─┘ ──┬────────────────────────────────────────┬── └─CLNTCODEPAGE(name)──HOSTCODEPAGE(name)─┘

Conditions:INVREQ, LENGERR

86

CICS User’s Handbook

API syntax

WEB RETRIEVE
──WEB──RETRIEVE──DOCTOKEN(data-area)──

Conditions:INVREQ

WEB SEND
──WEB──SEND──DOCTOKEN(name)──┬────────────────────┬────────────────────── └─CLNTCODEPAGE(name)─┘ ──┬────────────────────────┬────────────────────────────────────────────── └─STATUSCODE(data-value)─┘ ──┬───────────────────────────────────────────┬── └─STATUSTEXT(data-area)──LENGTH(data-value)─┘

Conditions:INVREQ, NOTFND

WEB STARTBROWSE
──WEB──STARTBROWSE──HTTPHEADER──

Conditions:INVREQ

WEB WRITE
──WEB──WRITE──HTTPHEADER(data-area)──NAMELENGTH(data-value)────────────── ──VALUE(data-area)──VALUELENGTH(data-value)──

Conditions:INVREQ

Chapter 1. Command-level application programming

87

API syntax

WRITE
──WRITE──FILE(filename)───┬────────────┬───FROM(data-area)─────────────── └─MASSINSERT─┘ ──┬────────────────────┬──RIDFLD(data-area)──┬───────────────────────┬──── └─LENGTH(data-value)─┘ └─KEYLENGTH(data-value)─┘ ──┬───────────────────┬──┬─────┬───┬───────────┬─── └─SYSID(systemname)─┘ ├─RBA─┤ └─NOSUSPEND─┘ └─RRN─┘

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

WRITE JOURNALNAME
──WRITE JOURNALNAME(data-value)──JTYPEID(data-value)──FROM(data-area)──── ──┬─────────────────────┬──┬──────────────────┬─────────────────────────── └─FLENGTH(data-value)─┘ └─REQID(data-area)─┘ ──┬─────────────────────────────────────────────┬───┬──────┬────────────── └─PREFIX(data-value)──┬─────────────────────┬─┘ └─WAIT─┘ └─PFXLENG(data-value)─┘ ───┬───────────┬─── └─NOSUSPEND─┘

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

88

CICS User’s Handbook

API syntax

WRITE OPERATOR
──WRITE OPERATOR──TEXT(data-value)──┬───────────────────────┬──────────── └─TEXTLENGTH(data-area)─┘ ──┬───────────────────────────────────────────────┬─────────────────────── └─ROUTECODES(data-value)──NUMROUTES(data-value)─┘ ┌─EVENTUAL───────────────────────────────────────────────┐ ──┼────────────────────────────────────────────────────────┼── ├─ACTION(cvda)───────────────────────────────────────────┤ ├─CRITICAL───────────────────────────────────────────────┤ ├─IMMEDIATE──────────────────────────────────────────────┤ └─REPLY(data-area)──┤ lengths ├──┬─────────────────────┬─┘ └─TIMEOUT(data-value)─┘ lengths: ├──MAXLENGTH(data-area)──┬────────────────────────┬──┤ └─REPLYLENGTH(data-area)─┘

Conditions: EXPIRED, INVREQ, LENGERR

WRITEQ TD
──WRITEQ TD──QUEUE(name)──FROM(data-area)──┬────────────────────┬──────── └─LENGTH(data-value)─┘ ──┬───────────────────┬── └─SYSID(systemname)─┘

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

WRITEQ TS
──WRITEQ TS──┬─QUEUE(name)─┬──FROM(data-area)──┬────────────────────┬──── └─QNAME(name)─┘ └─LENGTH(data-value)─┘ ──┬──────────────────────────────┬──┬───────────────────┬───────────────── ├─NUMITEMS(data-area)──────────┤ └─SYSID(systemname)─┘ └─ITEM(data-area)──┬─────────┬─┘ └─REWRITE─┘ ┌─AUXILIARY─┐ ──┼───────────┼───┬───────────┬─── └─MAIN──────┘ └─NOSUSPEND─┘

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

Chapter 1. Command-level application programming

89

API syntax

XCTL
──XCTL──PROGRAM(name)──┬─────────────────────────────────────────────┬─── └─COMMAREA(data-area)──┬────────────────────┬─┘ └─LENGTH(data-value)─┘ ──┬──────────────────────────────────────────────────┬── └─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
──ACQUIRE TERMINAL(data-value)──┬──────────────────────┬───────────────── ├─NOQUEUE──────────────┤ ├─QALL──┬────────┬─────┤ │ └─RELREQ─┘ │ ├─QNOTENAB─────────────┤ └─QSESSLIM──┬────────┬─┘ └─RELREQ─┘ ──┬───────────────────────────────────────────────────┬── └─USERDATA(data-value)──┬─────────────────────────┬─┘ └─USERDATALEN(data-value)─┘

Conditions: INVREQ, LENGERR, NOTAUTH, TERMIDERR

© Copyright IBM Corp. 1989, 1999

91

SPI syntax

COLLECT STATISTICS
──COLLECT STATISTICS SET(ptr-ref)──┬──────────────────────┬────────────── ├─LASTRESET(data-area)─┤ └─┤ COL3 ├─────────────┘ ──┬─AUTOINSTALL──────────────────────────────┬── ├─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
──CREATE CONNECTION(data-value)────────────────────────────────────────── ──┬─ATTRIBUTES(data-value)ATTRLEN(data-value)─┬── ├─COMPLETE──────────────────────────────────┤ └─DISCARD───────────────────────────────────┘

Conditions: ILLOGIC, INVREQ, LENGERR, NOTAUTH

CREATE CONNECTION
CONNECTION attributes: ┌─ACCESSMETHOD(VTAM)─────┐ ┌─ATTACHSEC(LOCAL)──────┐ ├──┼────────────────────────┼──┼───────────────────────┼─────────────────── ├─ACCESSMETHOD(INDIRECT)─┤ ├─ATTACHSEC(IDENTIFY)───┤ ├─ACCESSMETHOD(IRC)──────┤ ├─ATTACHSEC(MIXIDPE)────┤ └─ACCESSMETHOD(XM)───────┘ ├─ATTACHSEC(PERSISTENT)─┤ └─ATTACHSEC(VERIFY)─────┘ ┌─AUTOCONNECT(NO)──┐ ┌─BINDSECURITY(NO)──┐ ┌─CONNTYPE(SPECIFIC)─┐ ──┼──────────────────┼──┼───────────────────┼──┼────────────────────┼───── ├─AUTOCONNECT(ALL)─┤ └─BINDSECURITY(YES)─┘ └─CONNTYPE(GENERIC)──┘ └─AUTOCONNECT(YES)─┘ ┌─DATASTREAM(USER)─────┐ ──┼──────────────────────┼──┬─────────────────────┬──┬───────────────┬──── ├─DATASTREAM(LMS)──────┤ └─DESCRIPTION(char58)─┘ └─INDSYS(char4)─┘ ├─DATASTREAM(SCS)──────┤ ├─DATASTREAM(STRFIELD)─┤ └─DATASTREAM(327 )─────┘ ┌─INSERVICE(YES)─┐ ┌─MAXQTIME(NO)─────┐ ──┼────────────────┼──┼──────────────────┼──┬────────────────┬──────────── └─INSERVICE(NO)──┘ └─MAXQTIME( -9999)─┘ └─NETNAME(char8)─┘ ┌─PSRECOVERY(SYSDEFAULT)─┐ ──┬────────────────┬──┼────────────────────────┼────────────────────────── ├─PROTOCOL(APPC)─┤ └─PSRECOVERY(NONE)───────┘ ├─PROTOCOL(EXCI)─┤ └─PROTOCOL(LU61)─┘ ┌─QUEUELIMIT(NO)─────┐ ┌─RECORDFORMAT(U)──┐ ──┼────────────────────┼──┼──────────────────┼──────────────────────────── └─QUEUELIMIT( -9999)─┘ └─RECORDFORMAT(VB)─┘ ──┬─────────────────────┬───────────────────────────────────────────────── └─REMOTESYSNET(char8)─┘ ──┬────────────────────────────────────────────┬────────────────────────── └─REMOTESYSTEM(char4)─┬───────────────────┬──┘ └─REMOTENAME(char4)─┘ ┌─SINGLESESS(NO)──┐ ┌─USEDFLTUSER(NO)──┐ ──┬─────────────────────┬──┼─────────────────┼──┼──────────────────┼────── └─SECURITYNAME(char8)─┘ └─SINGLESESS(YES)─┘ └─USEDFLTUSER(YES)─┘ ┌─XLNACTION(KEEP)──┐ ──┼──────────────────┼──┤ └─XLNACTION(FORCE)─┘

Chapter 2. SPI command syntax

93

SPI syntax

CREATE DB2CONN
──CREATE DB2CONN(data-value)───────────────────────────────────────────── ────ATTRIBUTES(data-value)ATTRLEN(data-value)────

Conditions: ILLOGIC, INVREQ, LENGERR, NOTAUTH

CREATE DB2CONN
DB2CONN attributes: ┌─CONNECTERROR(sqlcode)─┐ ├──┬─────────────────────┬──┼───────────────────────┼──┬──────────────┬──── └─DESCRIPTION(char58)─┘ └─CONNECTERROR(abend)───┘ └─DB2ID(char4)─┘ ┌─MSGQUEUE1(CDB2)──┐ ──┼──────────────────┼──┬──────────────────┬──┬──────────────────┬──────── └─MSGQUEUE1(char4)─┘ └─MSGQUEUE2(char4)─┘ └─MSGQUEUE3(char4)─┘ ┌─NONTERMREL(yes)─┐ ┌─PURGECYCLE( ,3 )──────┐ ──┼─────────────────┼──┼───────────────────────┼──┬───────────────┬─────── └─NONTERMREL(no)──┘ └─PURGECYCLE( -59, -59)─┘ └─SIGNID(char8)─┘ ┌─STANDBYMODE(reconnect)─┐ ┌─STATSQUEUE(CDB2)──┐ ──┼────────────────────────┼──┼───────────────────┼─────────────────────── ├─STANDBYMODE(noconnect)─┤ └─STATSQUEUE(char4)─┘ └─STANDBYMODE(connect)───┘ ┌─TCBLIMIT(12)─────┐ ┌─THREADERROR(n9 6d)─┐ ┌─ACCOUNTREC(none)─┐ ──┼──────────────────┼──┼────────────────────┼──┼──────────────────┼────── └─TCBLIMIT(4-2 )─┘ ├─THREADERROR(abend)─┤ ├─ACCOUNTREC(uow)──┤ └─THREADERROR(n9 6)──┘ ├─ACCOUNTREC(task)─┤ └─ACCOUNTREC(txid)─┘ ┌─AUTHTYPE(userid)─┐ ┌─DROLLBACK(yes)─┐ ──┬───────────────┬──┼──────────────────┼──┼────────────────┼───────────── └─AUTHID(char8)─┘ ├─AUTHTYPE(group)──┤ └─DROLLBACK(no)──┘ ├─AUTHTYPE(signid)─┤ ├─AUTHTYPE(term)───┤ ├─AUTHTYPE(txid)───┤ └─AUTHTYPE(opid)───┘ ┌─PLANEXITNAME(DSNCUEXT)─┐ ┌─PRIORITY(high)──┐ ──┬─────────────┬──┼────────────────────────┼──┼─────────────────┼──────── └─PLAN(char8)─┘ └─PLANEXITNAME(char8)────┘ ├─PRIORITY(equal)─┤ └─PRIORITY(low)───┘ ┌─THREADLIMIT(3)──────┐ ┌─THREADWAIT(yes)─┐ ──┼─────────────────────┼──┼─────────────────┼──┬──────────────────┬────── └─THREADLIMIT(3-2 )─┘ └─THREADWAIT(no)──┘ └─COMAUTHID(char8)─┘ ┌─COMAUTHTYPE(userid)─┐ ┌─COMTHREADLIM(1)──────┐ ──┼─────────────────────┼──┼──────────────────────┼──┤ ├─COMAUTHTYPE(group)──┤ └─COMTHREADLIM( -2 )─┘ ├─COMAUTHTYPE(signid)─┤ ├─COMAUTHTYPE(term)───┤ ├─COMAUTHTYPE(txid)───┤ └─COMAUTHTYPE(user)───┘

94

CICS User’s Handbook

SPI syntax

CREATE DB2ENTRY
──CREATE DB2ENTRY(data-value)──────────────────────────────────────────── ────ATTRIBUTES(data-value)ATTRLEN(data-value)────

Conditions: ILLOGIC, INVREQ, LENGERR, NOTAUTH

CREATE DB2ENTRY
DB2ENTRY attributes: ┌─ACCOUNTREC(none)─┐ ├──┬─────────────────────┬──┬────────────────┬──┼──────────────────┼─────── └─DESCRIPTION(char58)─┘ └─TRANSID(char4)─┘ ├─ACCOUNTREC(uow)──┤ ├─ACCOUNTREC(task)─┤ └─ACCOUNTREC(txid)─┘ ┌─AUTHTYPE(userid)─┐ ┌─DROLLBACK(yes)─┐ ──┬───────────────┬──┼──────────────────┼──┼────────────────┼───────────── └─AUTHID(char8)─┘ ├─AUTHTYPE(group)──┤ └─DROLLBACK(no)──┘ ├─AUTHTYPE(signid)─┤ ├─AUTHTYPE(term)───┤ ├─AUTHTYPE(txid)───┤ └─AUTHTYPE(opid)───┘ ┌─PLANEXITNAME(DSNCUEXT)─┐ ┌─PRIORITY(high)──┐ ──┬─────────────┬──┼────────────────────────┼──┼─────────────────┼──────── └─PLAN(char8)─┘ └─PLANEXITNAME(char8)────┘ ├─PRIORITY(equal)─┤ └─PRIORITY(low)───┘ ┌─PROTECTNUM( )──────┐ ┌─THREADLIMIT( )──────┐ ──┼────────────────────┼──┼─────────────────────┼───────────────────────── └─PROTECTNUM( -2 )─┘ └─THREADLIMIT( -2 )─┘ ┌─THREADWAIT(pool)─┐ ──┼──────────────────┼──┤ ├─THREADWAIT(yes)──┤ └─THREADWAIT(no)───┘

CREATE DB2TRAN
──CREATE DB2TRAN(data-value)───────────────────────────────────────────── ────ATTRIBUTES(data-value)ATTRLEN(data-value)────

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
──CREATE DOCTEMPLATE(data-value)───────────────────────────────────────── ────ATTRIBUTES(data-value)ATTRLEN(data-value)────

Conditions: ILLOGIC, INVREQ, LENGERR, NOTAUTH

CREATE DOCTEMPLATE
DOCTEMPLATE attributes: ┌─APPENDCRLF(YES)─┐ ├──┼─────────────────┼──┬─────────────────────┬──────────────────────────── └─APPENDCRLF(NO)──┘ └─DESCRIPTION(char58)─┘ ──┬─FILE(char8)────────────────────────────┬──┬──────────────────────┬──┤ ├─TSQUEUE(char16)────────────────────────┤ └─TEMPLATENAME(char48)─┘ ├─TDQUEUE(char4)─────────────────────────┤ ├─PROGRAM(char8)─────────────────────────┤ ├─EXITPGM(char8)─────────────────────────┤ │ ┌─DDNAME(DFHHTML)─┐ │ └─MEMBERNAME(char8)─┼─────────────────┼──┘ └─DDNAME(char8)───┘

||
| |

CREATE ENQMODEL
──CREATE ENQMODEL(data-value)──────────────────────────────────────────── ────ATTRIBUTES(data-value)ATTRLEN(data-value)────

|

Conditions: INVREQ, LENGERR, NOTAUTH

96

CICS User’s Handbook

SPI syntax

| | | | | | | |

CREATE ENQMODEL
ENQMODEL attributes: ├──┬─────────────────────┬──ENQNAME(char1-255)──┬─────────────────┬──────── └─DESCRIPTION(char58)─┘ └─ENQSCOPE(char4)─┘ ┌─STATUS(ENABLED)──┐ ──┼──────────────────┼──┤ └─STATUS(DISABLED)─┘

CREATE FILE
──CREATE FILE(data-value)────ATTRIBUTES(data-value)────────────────────── ──ATTRLEN(data-value)──

Conditions: ILLOGIC, INVREQ, LENGERR, NOTAUTH

CREATE FILE
FILE attributes (1/2): ┌─ADD(NO)──┐ ┌─BACKUPTYPE(STATIC)──┐ ┌─BROWSE(NO)──┐ ├──┼──────────┼──┼─────────────────────┼──┼─────────────┼────────────────── └─ADD(YES)─┘ └─BACKUPTYPE(DYNAMIC)─┘ └─BROWSE(YES)─┘ ┌─DATABUFFERS(2)───────┐ ┌─DELETE(NO)──┐ ──┬─────────────────┬──┼──────────────────────┼──┼─────────────┼────────── └─CFDTPOOL(char8)─┘ └─DATABUFFERS(2-32767)─┘ └─DELETE(YES)─┘ ┌─DISPOSITION(SHARE)─┐ ──┬─────────────────────┬──┼────────────────────┼──┬────────────────┬───── └─DESCRIPTION(char58)─┘ └─DISPOSITION(OLD)───┘ └─DSNAME(char44)─┘ ┌─DSNSHARING(ALLREQS)────┐ ┌─FWDRECOVLOG(NO)───┐ ──┼────────────────────────┼──┼───────────────────┼─────────────────────── └─DSNSHARING(MODIFYREQS)─┘ └─FWDRECOVLOG(1-99)─┘ ┌─INDEXBUFFERS(1)───────┐ ┌─JNLADD(NONE)───┐ ──┼───────────────────────┼──┼────────────────┼─────────────────────────── └─INDEXBUFFERS(1-32767)─┘ ├─JNLADD(AFTER)──┤ ├─JNLADD(ALL)────┤ └─JNLADD(BEFORE)─┘ ┌─JNLREAD(NONE)───────┐ ┌─JNLSYNCREAD(NO)──┐ ┌─JNLSYNCWRITE(YES)─┐ ──┼─────────────────────┼──┼──────────────────┼──┼───────────────────┼──── ├─JNLREAD(ALL)────────┤ └─JNLSYNCREAD(YES)─┘ └─JNLSYNCWRITE(NO)──┘ ├─JNLREAD(READONLY)───┤ └─JNLREAD(UPDATEONLY)─┘ ┌─JNLUPDATE(NO)──┐ ┌─JOURNAL(NO)───┐ ──┼────────────────┼──┼───────────────┼──┤ └─JNLUPDATE(YES)─┘ └─JOURNAL(1-99)─┘

|

Chapter 2. SPI command syntax

97

SPI syntax

CREATE FILE
FILE attributes (2/2): | | | | ┌─LOAD(NO)──┐ ├──┬────────────────────────────────┬──┼───────────┼─────────────────────── └─KEYLENGTH(1-255|1-16 for CFDT)─┘ └─LOAD(YES)─┘ ┌─LSRPOOLID(1)────┐ ┌─MAXNUMRECS(NOLIMIT)────────┐ ──┼─────────────────┼──┼────────────────────────────┼───────────────────── ├─LSRPOOLID(NONE)─┤ └─┬────────────────────────┬─┘ └─LSRPOOLID(1-8)──┘ └─MAXNUMRECS(1-99999999)─┘ ┌─OPENTIME(FIRSTREF)─┐ ──┬─────────────────┬──┼────────────────────┼──┬─────────────────┬──────── └─NSRGROUP(char8)─┘ └─OPENTIME(STARTUP)──┘ └─PASSWORD(char8)─┘ ┌─READ(YES)─┐ ┌─READINTEG(UNCOMMITTED)─┐ ┌─RECORDFORMAT(V)─┐ ──┼───────────┼──┼────────────────────────┼──┼─────────────────┼────────── └─READ(NO)──┘ ├─READINTEG(CONSISTENT)──┤ └─RECORDFORMAT(F)─┘ └─READINTEG(REPEATABLE)──┘ ┌─RECOVERY(NONE)────────┐ ──┬─────────────────────┬──┼───────────────────────┼────────────────────── └─RECORDSIZE(1-32767)─┘ ├─RECOVERY(ALL)─────────┤ └─RECOVERY(BACKOUTONLY)─┘ ┌─RLSACCESS(NO)──┐ ──┬────────────────────────────────────────────┬──┼────────────────┼────── └─REMOTESYSTEM(char4)─┬───────────────────┬──┘ └─RLSACCESS(YES)─┘ └─REMOTENAME(char8)─┘ ┌─STATUS(ENABLED)───┐ ┌─STRINGS(1)─────┐ ┌─TABLE(NO)───┐ ──┼───────────────────┼──┼────────────────┼──┼─────────────┼────────────── ├─STATUS(DISABLED)──┤ └─STRINGS(1-255)─┘ ├─TABLE(CF)───┤ └─STATUS(UNENABLED)─┘ ├─TABLE(CICS)─┤ └─TABLE(USER)─┘ ┌─UPDATE(NO)──┐ ┌─UPDATEMODEL(LOCKING)────┐ ──┬──────────────────┬──┼─────────────┼──┼─────────────────────────┼──┤ └─TABLENAME(char8)─┘ └─UPDATE(YES)─┘ └─UPDATEMODEL(CONTENTION)─┘

|

| |

CREATE JOURNALMODEL
──CREATE JOURNALMODEL(data-value)──────────────────────────────────────── ────ATTRIBUTES(data-value)ATTRLEN(data-value)────

Conditions: ILLOGIC, INVREQ, LENGERR, NOTAUTH

98

CICS User’s Handbook

SPI syntax

CREATE JOURNALMODEL
JOURNALMODEL attributes: ├──┬─────────────────────┬──┬────────────────────┬───────────────────────── └─DESCRIPTION(char58)─┘ └─JOURNALNAME(char8)─┘ ┌─STREAMNAME(&USERID..&APPLID..&JNAME;)─┐ ┌─TYPE(MVS)───┐ ──┼───────────────────────────────────────┼──┼─────────────┼──┤ └─STREAMNAME(char26)────────────────────┘ ├─TYPE(DUMMY)─┤ └─TYPE(SMF)───┘

CREATE LSRPOOL
──CREATE LSRPOOL(data-value)──ATTRIBUTES(data-value)───────────────────── ──ATTRLEN(data-value)──

Conditions: ILLOGIC, INVREQ, LENGERR, NOTAUTH

Chapter 2. SPI command syntax

99

SPI syntax

CREATE LSRPOOL
LSRPOOL attributes: ├──┬──────────────────┬──┬─────────────────┬──┬─────────────────┬────────── └─DATA512(3-32767)─┘ └─DATA1K(3-32767)─┘ └─DATA2K(3-32767)─┘ ──┬─────────────────┬──┬─────────────────┬──┬──────────────────┬────────── └─DATA4K(3-32767)─┘ └─DATA8K(3-32767)─┘ └─DATA12K(3-32767)─┘ ──┬──────────────────┬──┬──────────────────┬──┬──────────────────┬──────── └─DATA16K(3-32767)─┘ └─DATA2 K(3-32767)─┘ └─DATA24K(3-32767)─┘ ──┬──────────────────┬──┬──────────────────┬──┬─────────────────────┬───── └─DATA28K(3-32767)─┘ └─DATA32K(3-32767)─┘ └─DESCRIPTION(char58)─┘ ──┬──────────────────────┬──┬──────────────────────┬────────────────────── └─HSDATA4K( -16777215)─┘ └─HSDATA8K( -16777215)─┘ ──┬───────────────────────┬──┬───────────────────────┬──────────────────── └─HSDATA12K( -16777215)─┘ └─HSDATA16K( -16777215)─┘ ──┬───────────────────────┬──┬───────────────────────┬──────────────────── └─HSDATA2 K( -16777215)─┘ └─HSDATA24K( -16777215)─┘ ──┬───────────────────────┬──┬───────────────────────┬──────────────────── └─HSDATA28K( -16777215)─┘ └─HSDATA32K( -16777215)─┘ ──┬───────────────────────┬──┬───────────────────────┬──────────────────── └─HSINDEX4K( -16777215)─┘ └─HSINDEX8K( -16777215)─┘ ──┬────────────────────────┬──┬────────────────────────┬────────────────── └─HSINDEX12K( -16777215)─┘ └─HSINDEX16K( -16777215)─┘ ──┬────────────────────────┬──┬────────────────────────┬────────────────── └─HSINDEX2 K( -16777215)─┘ └─HSINDEX24K( -16777215)─┘ ──┬────────────────────────┬──┬────────────────────────┬────────────────── └─HSINDEX28K( -16777215)─┘ └─HSINDEX32K( -16777215)─┘ ──┬───────────────────┬──┬──────────────────┬──┬──────────────────┬─────── └─INDEX512(3-32767)─┘ └─INDEX1K(3-32767)─┘ └─INDEX2K(3-32767)─┘ ──┬──────────────────┬──┬──────────────────┬──┬───────────────────┬─────── └─INDEX4K(3-32767)─┘ └─INDEX8K(3-32767)─┘ └─INDEX12K(3-32767)─┘ ──┬───────────────────┬──┬───────────────────┬──┬───────────────────┬───── └─INDEX16K(3-32767)─┘ └─INDEX2 K(3-32767)─┘ └─INDEX24K(3-32767)─┘ ┌─LSRPOOLID(1)───┐ ──┬───────────────────┬──┬───────────────────┬──┼────────────────┼──────── └─INDEX28K(3-32767)─┘ └─INDEX32K(3-32767)─┘ └─LSRPOOLID(1-8)─┘ ┌─SHARELIMIT(5 )────┐ ──┬─────────────────────┬──┼───────────────────┼──┬────────────────┬──┤ └─MAXKEYLENGTH( -255)─┘ └─SHARELIMIT(1-1 )─┘ └─STRINGS(1-255)─┘

CREATE MAPSET
──CREATE MAPSET(data-value)────────────────────────────────────────────── ────ATTRIBUTES(data-value)ATTRLEN(data-value)────

Conditions: ILLOGIC, INVREQ, LENGERR, NOTAUTH

100

CICS User’s Handbook

SPI syntax

CREATE MAPSET
MAPSET attributes: ┌─RESIDENT(NO)──┐ ┌─STATUS(ENABLED)──┐ ├──┬─────────────────────┬──┼───────────────┼──┼──────────────────┼──────── └─DESCRIPTION(char58)─┘ └─RESIDENT(YES)─┘ └─STATUS(DISABLED)─┘ ┌─USAGE(NORMAL)────┐ ┌─USELPACOPY(NO)──┐ ──┼──────────────────┼──┼─────────────────┼──┤ └─USAGE(TRANSIENT)─┘ └─USELPACOPY(YES)─┘

CREATE PARTITIONSET
──CREATE PARTITIONSET(data-value)──────────────────────────────────────── ────ATTRIBUTES(data-value)ATTRLEN(data-value)────

Conditions: ILLOGIC, INVREQ, LENGERR, NOTAUTH

CREATE PARTITIONSET
PARTITIONSET attributes: ┌─RESIDENT(NO)──┐ ┌─STATUS(ENABLED)──┐ ├──┬─────────────────────┬──┼───────────────┼──┼──────────────────┼──────── └─DESCRIPTION(char58)─┘ └─RESIDENT(YES)─┘ └─STATUS(DISABLED)─┘ ┌─USAGE(NORMAL)────┐ ┌─USELPACOPY(NO)──┐ ──┼──────────────────┼──┼─────────────────┼──┤ └─USAGE(TRANSIENT)─┘ └─USELPACPOY(YES)─┘

CREATE PARTNER
──CREATE PARTNER(data-value)───────────────────────────────────────────── ────ATTRIBUTES(data-value)ATTRLEN(data-value)────

Conditions: ILLOGIC, INVREQ, LENGERR, NOTAUTH

Chapter 2. SPI command syntax

101

SPI syntax

CREATE PARTNER
PARTNER attributes: ├──┬─────────────────────┬──NETNAME(char8)──┬────────────────┬───────────── └─DESCRIPTION(char58)─┘ └─NETWORK(char8)─┘ ┌─PROFILE(DFHCICSA)─┐ ──┼───────────────────┼──┬─TPNAME(char64)──┬──┤ └─PROFILE(char8)────┘ └─XTPNAME(hex128)─┘

CREATE PROCESSTYPE
──CREATE PROCESSTYPE(data-value)──ATTRIBUTES(data-value)───────────────── ──ATTRLEN(data-value)──

Conditions: ILLOGIC, INVREQ, LENGERR, NOTAUTH

CREATE PROCESSTYPE
PROCESSTYPE attributes: ├──┬─────────────────────┬──FILE(char8)──┬─────────────────┬─────────────── └─DESCRIPTION(char58)─┘ └─AUDITLOG(char8)─┘ ┌─AUDITLEVEL(OFF)──────┐ ┌─STATUS(ENABLED)──┐ ──┼──────────────────────┼──┼──────────────────┼──┤ ├─AUDITLEVEL(ACTIVITY)─┤ └─STATUS(DISABLED)─┘ ├─AUDITLEVEL(FULL)─────┤ └─AUDITLEVEL(PROCESS)──┘

CREATE PROFILE
──CREATE PROFILE(data-value)───────────────────────────────────────────── ────ATTRIBUTES(data-value)ATTRLEN(data-value)────

Conditions: ILLOGIC, INVREQ, LENGERR, NOTAUTH

102

CICS User’s Handbook

SPI syntax

CREATE PROFILE
PROFILE attributes: ┌─CHAINCONTROL(NO)──┐ ┌─DVSUPRT(ALL)─────┐ ├──┼───────────────────┼──┬─────────────────────┬──┼──────────────────┼──── └─CHAINCONTROL(YES)─┘ └─DESCRIPTION(char58)─┘ ├─DVSUPRT(NONVTAM)─┤ └─DVSUPRT(VTAM)────┘ ┌─INBFMH(NO)───┐ ┌─JOURNAL(NO)───┐ ┌─LOGREC(NO)──┐ ──┼──────────────┼──┼───────────────┼──┼─────────────┼──────────────────── ├─INBFMH(ALL)──┤ └─JOURNAL(1-99)─┘ └─LOGREC(YES)─┘ ├─INBFMH(DIP)──┤ └─INBFMH(EODS)─┘ ┌─MSGINTEG(NO)──┐ ┌─MSGJRNL(NO)─────┐ ──┬─────────────────┬──┼───────────────┼──┼─────────────────┼───────────── └─MODENAME(char8)─┘ └─MSGINTEG(YES)─┘ ├─MSGJRNL(INOUT)──┤ ├─MSGJRNL(INPUT)──┤ └─MSGJRNL(OUTPUT)─┘ ┌─NEPCLASS( )─────┐ ┌─ONEWTE(NO)──┐ ┌─PRINTERCOMP(NO)──┐ ──┼─────────────────┼──┼─────────────┼──┼──────────────────┼────────────── └─NEPCLASS( -255)─┘ └─ONEWTE(YES)─┘ └─PRINTERCOMP(YES)─┘ ┌─PROTECT(NO)──┐ ┌─RAQ(NO)──┐ ┌─RTIMOUT(NO)─────┐ ──┼──────────────┼──┼──────────┼──┼─────────────────┼───────────────────── └─PROTECT(YES)─┘ └─RAQ(YES)─┘ └─RTIMOUT(1-7 )─┘ ┌─SCRNSIZE(DEFAULT)───┐ ┌─UCTRAN(NO)──┐ ──┼─────────────────────┼──┼─────────────┼──┤ └─SCRNSIZE(ALTERNATE)─┘ └─UCTRAN(YES)─┘

CREATE PROGRAM
──CREATE PROGRAM(data-value)───────────────────────────────────────────── ────ATTRIBUTES(data-value)ATTRLEN(data-value)────

Conditions: ILLOGIC, INVREQ, LENGERR, NOTAUTH

Chapter 2. SPI command syntax

103

SPI syntax

CREATE PROGRAM
PROGRAM attributes: ┌─CEDF(YES)─┐ ┌─CONCURRENCY(QUASIRENT)──┐ ┌─DATALOCATION(BELOW)─┐ ├──┼───────────┼──┼─────────────────────────┼──┼─────────────────────┼───── └─CEDF(NO)──┘ └─CONCURRENCY(THREADSAFE)─┘ └─DATALOCATION(ANY)───┘ ┌─EXECKEY(USER)─┐ ──┬─────────────────────┬──┼───────────────┼────────────────────────────── └─DESCRIPTION(char58)─┘ └─EXECKEY(CICS)─┘ | | | ┌─EXECUTIONSET(FULLAPI)───┐ ┌─JVM(NO)────┐ ──┼─────────────────────────┼──┬───────────────────┬──┼────────────┼────── └─EXECUTIONSET(DPLSUBSET)─┘ └─JVMCLASS(char255)─┘ ├─JVM(DEBUG)─┤ └─JVM(YES)───┘ ┌─RELOAD(NO)──┐ ──┬─────────────────────┬──┼─────────────┼──────────────────────────────── ├─LANGUAGE(ASSEMBLER)─┤ └─RELOAD(YES)─┘ ├─LANGUAGE(C)─────────┤ ├─LANGUAGE(COBOL)─────┤ ├─LANGUAGE(LE37 )─────┤ └─LANGUAGE(PLI)───────┘ ┌─RESIDENT(NO)──┐ ──┬────────────────────────────────────────────┬──┼───────────────┼─────── └─REMOTESYSTEM(char4)─┬───────────────────┬──┘ └─RESIDENT(YES)─┘ └─REMOTENAME(char8)─┘ ┌─STATUS(ENABLED)──┐ ┌─USAGE(NORMAL)────┐ ──┼──────────────────┼──┬────────────────┬──┼──────────────────┼────────── └─STATUS(DISABLED)─┘ └─TRANSID(char4)─┘ └─USAGE(TRANSIENT)─┘ ┌─USELPACOPY(NO)──┐ ──┼─────────────────┼──┤ └─USELPACOPY(YES)─┘

CREATE REQUESTMODEL
──CREATE REQUESTMODEL(data-value)──────────────────────────────────────── ────ATTRIBUTES(data-value)ATTRLEN(data-value)────

Conditions: ILLOGIC, INVREQ, LENGERR, NOTAUTH

CREATE REQUESTMODEL
REQUESTMODEL attributes: ├──┬─────────────────────┬──OMGMODULE(char58)──OMGINTERFACE(char31)──────── └─DESCRIPTION(char58)─┘ ──OMGOPERATION(char31)──TRANSID(char4)──┤

104

CICS User’s Handbook

SPI syntax

CREATE SESSIONS
──CREATE SESSIONS(data-value)──────────────────────────────────────────── ────ATTRIBUTES(data-value)ATTRLEN(data-value)────

Conditions: ILLOGIC, INVREQ, LENGERR, NOTAUTH

CREATE SESSIONS
SESSIONS attributes: ┌─AUTOCONNECT(NO)──┐ ┌─BUILDCHAIN(YES)─┐ ├──┼──────────────────┼──┼─────────────────┼──CONNECTION(char4)──────────── ├─AUTOCONNECT(ALL)─┤ └─BUILDCHAIN(NO)──┘ └─AUTOCONNECT(YES)─┘ ┌─DISCREQ(NO)──┐ ──┬─────────────────────┬──┼──────────────┼─────────────────────────────── └─DESCRIPTION(char58)─┘ └─DISCREQ(YES)─┘ ┌─IOAREALEN( , )─────────────┐ ┌─MAXIMUM(1, )─────────┐ ──┼────────────────────────────┼──┼──────────────────────┼──────────────── └─IOAREALEN( -32767, -32767)─┘ └─MAXIMUM( -999, -999)─┘ ┌─NEPCLASS( )─────┐ ──┬─────────────────┬──┼─────────────────┼──┬─────────────────┬─────────── └─MODENAME(char8)─┘ └─NEPCLASS( -255)─┘ └─NETNAMEQ(char8)─┘ ┌─PROTOCOL(APPC)─┐ ──┼────────────────┼──┬─────────────────────┬──┬───────────────────┬────── ├─PROTOCOL(LU61)─┤ └─RECEIVECOUNT(1-999)─┘ └─RECEIVEPFX(char2)─┘ └─PROTOCOL(EXCI)─┘ ┌─RECEIVESIZE(4 96)────┐ ┌─RECOVOPTION(SYSDEFAULT)──┐ ──┼──────────────────────┼──┼──────────────────────────┼────────────────── └─RECEIVESIZE(1-3 72 )─┘ ├─RECOVOPTION(CLEARCONV)───┤ ├─RECOVOPTION(NONE)────────┤ ├─RECOVOPTION(RELEASESESS)─┤ └─RECOVOPTION(UNCONDREL)───┘ ┌─RELREQ(NO)──┐ ──┼─────────────┼──┬──────────────────┬──┬────────────────┬─────────────── └─RELREQ(YES)─┘ └─SENDCOUNT(1-999)─┘ └─SENDPFX(char2)─┘ ┌─SENDSIZE(4 96)────┐ ┌─SESSPRIORITY( )─────┐ ──┼───────────────────┼──┬─────────────────┬──┼─────────────────────┼───── └─SENDSIZE(1-3 72 )─┘ └─SESSNAME(char4)─┘ └─SESSPRIORITY( -255)─┘ ┌─USERAREALEN( )─────┐ ──┼────────────────────┼──┬───────────────┬──┤ └─USERAREALEN( -255)─┘ └─USERID(char8)─┘

Chapter 2. SPI command syntax

105

SPI syntax

CREATE TCPIPSERVICE
──CREATE TCPIPSERVICE(data-value)──────────────────────────────────────── ────ATTRIBUTES(data-value)ATTRLEN(data-value)────

Conditions: ILLOGIC, INVREQ, LENGERR, NOTAUTH

CREATE TCPIPSERVICE
TCPIPSERVICE attributes: ┌─BACKLOG( )───────┐ ├──┼──────────────────┼──┬─────────────────────┬─────────────────────────── └─BACKLOG( -32767)─┘ └─CERTIFICATE(char44)─┘ ──┬─────────────────────┬──┬───────────────────┬──┬─────────────────┬───── └─DESCRIPTION(char58)─┘ └─IPADDRESS(char15)─┘ └─KEYFILE(char44)─┘ ┌─SSL(NO)─────────┐ ┌─STATUS(OPEN)───┐ ──PORTNUMBER(1-32767)──┼─────────────────┼──┼────────────────┼──────────── ├─SSL(YES)────────┤ └─STATUS(CLOSED)─┘ └─SSL(CLIENTAUTH)─┘ ──TRANSACTION(char4)──┬──────────────────┬──┬────────────┬──┤ └─TSQPREFIX(char6)─┘ └─URM(char8)─┘

CREATE TDQUEUE
──CREATE TDQUEUE(data-value)───────────────────────────────────────────── ────ATTRIBUTES(data-value)ATTRLEN(data-value)────

Conditions: ILLOGIC, INVREQ, LENGERR, NOTAUTH

106

CICS User’s Handbook

SPI syntax

TDQUEUE attributes for extra-partition queues: ├──TYPE(EXTRA)──┬────────────────────────┬────────────────────── ├─BLOCKFORMAT(BLOCKED)───┤ └─BLOCKFORMAT(UNBLOCKED)─┘ ┌─BLOCKSIZE( )───────┐ ┌─DATABUFFERS(1)─────┐ ──┼────────────────────┼──┼────────────────────┼─────────────── └─BLOCKSIZE( -32767)─┘ └─DATABUFFERS(1-255)─┘ ──DDNAME(char8)──┬─────────────────────┬─────────────────────── └─DESCRIPTION(char58)─┘ ┌─DISPOSITION(SHR)─┐ ──┼──────────────────┼──┬────────────────┬───────────────────── ├─DISPOSITION(OLD)─┤ ├─DSNAME(DUMMY)──┤ └─DISPOSITION(MOD)─┘ └─DSNAME(char44)─┘ ┌─ERROROPTION(IGNORE)─┐ ┌─OPENTIME(INITIAL)──┐ ──┼─────────────────────┼──┼────────────────────┼────────────── └─ERROROPTION(SKIP)───┘ └─OPENTIME(DEFERRED)─┘ ──┬─────────────────┬──┬────────────────────────┬────────────── ├─PRINTCONTROL(A)─┤ ├─RECORDFORMAT(FIXED)────┤ └─PRINTCONTROL(M)─┘ └─RECORDFORMAT(VARIABLE)─┘ ┌─RECORDSIZE( )───────┐ ──┼─────────────────────┼────────────────────────────────────── └─RECORDSIZE( -32767)─┘ ──┬──────────────────────────────────────────────────┬───────── │ ┌── ─────────────────────────┐ │ └─REMOTESYSTEM(char4)──┬───────────────────────┬┴──┘ ├─REMOTELENGTH( -32767)─┤ └─REMOTENAME(char4)─────┘ ┌─SYSOUTCLASS( )─────┐ ──┬────────────────┬──┼────────────────────┼─────────────────── ├─REWIND(LEAVE)──┤ └─SYSOUTCLASS(char1)─┘ └─REWIND(REREAD)─┘ ┌─TYPEFILE(INPUT)──┐ ──┼──────────────────┼─────────────────────────────────────────┤ ├─TYPEFILE(OUTPUT)─┤ └─TYPEFILE(RDBACK)─┘

Chapter 2. SPI command syntax

107

SPI syntax

TDQUEUE attributes for intra-partition queues: ┌─ATIFACILITY(TERMINAL)─┐ ├──TYPE(INTRA)──┼───────────────────────┼─────────────────────── ├─ATIFACILITY(FILE)─────┤ └─ATIFACILITY(SYSTEM)───┘ ──┬─────────────────────┬──┬───────────────────┬─────────────── └─DESCRIPTION(char58)─┘ └─FACILITYID(char4)─┘ ┌─RECOVSTATUS(NO)───────┐ ──┼───────────────────────┼──────────────────────────────────── ├─RECOVSTATUS(LOGICAL)──┤ └─RECOVSTATUS(PHYSICAL)─┘ ──┬──────────────────────────────────────────────────┬───────── │ ┌── ─────────────────────────┐ │ └─REMOTESYSTEM(char4)──┬───────────────────────┬┴──┘ ├─REMOTELENGTH( -32767)─┤ └─REMOTENAME(char4)─────┘ ┌─TRIGGERLEVEL(1)───────┐ ──┬────────────────┬──┼───────────────────────┼──────────────── └─TRANSID(char4)─┘ └─TRIGGERLEVEL( -32767)─┘ ┌─WAIT(YES)─┐ ┌─WAITACTION(REJECT)─┐ ──┬───────────────┬──┼───────────┼──┼────────────────────┼─────┤ └─USERID(char8)─┘ └─WAIT(NO)──┘ └─WAITACTION(QUEUE)──┘

TDQUEUE attributes for indirect queues: ├──TYPE(INDIRECT)──┬─────────────────────┬────────────────────── └─DESCRIPTION(char58)─┘ ──INDIRECTNAME(char4)────────────────────────────────────────── ──┬──────────────────────────────────────────────────┬─────────┤ │ ┌── ─────────────────────────┐ │ └─REMOTESYSTEM(char4)──┬───────────────────────┬┴──┘ ├─REMOTELENGTH( -32767)─┤ └─REMOTENAME(char4)─────┘

108

CICS User’s Handbook

SPI syntax

TDQUEUE attributes for remote queues of unspecified TYPE: ├──┬─────────────────────┬──┬───────────────────────┬─────────── └─DESCRIPTION(char58)─┘ └─REMOTELENGTH( -32767)─┘ ──┬───────────────────┬──REMOTESYSTEM(char4)───────────────────┤ └─REMOTENAME(char4)─┘

CREATE TERMINAL
──CREATE TERMINAL(data-value)──────────────────────────────────────────── ──┬─ATTRIBUTES(data-value)ATTRLEN(data-value)─┬── ├─COMPLETE──────────────────────────────────┤ └─DISCARD───────────────────────────────────┘

Conditions: ILLOGIC, INVREQ, LENGERR, NOTAUTH

Chapter 2. SPI command syntax

109

SPI syntax

CREATE TERMINAL
TERMINAL attributes: ┌─ALTPRINTCOPY(NO)──┐ ├──┼───────────────────┼──┬───────────────────┬──────────────────────────── └─ALTPRINTCOPY(YES)─┘ └─ALTPRINTER(char4)─┘ ┌─ATTACHSEC(LOCAL)──────┐ ┌─AUTINSTMODEL(NO)───┐ ──┼───────────────────────┼──┼────────────────────┼─────────────────────── ├─ATTACHSEC(IDENTIFY)───┤ ├─AUTINSTMODEL(ONLY)─┤ ├─ATTACHSEC(MIXIDPE)────┤ └─AUTINSTMODEL(YES)──┘ ├─ATTACHSEC(PERSISTENT)─┤ └─ATTACHSEC(VERIFY)─────┘ ──┬────────────────────┬──┬─────────────────────┬───────────────────────── └─AUTINSTNAME(char8)─┘ └─BINDPASSWORD(hex16)─┘ ┌─BINDSECURITY(NO)──┐ ┌─CONSOLE(NO)─────┐ ──┼───────────────────┼──┼─────────────────┼──┬─────────────────────┬───── └─BINDSECURITY(YES)─┘ ├─CONSOLE( -25 )──┤ └─DESCRIPTION(char58)─┘ └─CONSNAME(char8)─┘ ┌─INSERVICE(YES)─┐ ──┼────────────────┼──┬─────────────────┬──┬────────────┬───────────────── └─INSERVICE(NO)──┘ └─MODENAME(char8)─┘ ├─NATLANG(E)─┤ └─NATLANG(K)─┘ ──┬────────────────┬──┬─────────────┬──┬────────────────┬───────────────── └─NETNAME(char8)─┘ └─POOL(char8)─┘ └─PRINTER(char4)─┘ ┌─PRINTERCOPY(NO)──┐ ──┼──────────────────┼──┬─────────────────────┬─────────────────────────── └─PRINTERCOPY(YES)─┘ └─REMOTESYSNET(char8)─┘ ──┬────────────────────────────────────────────┬────────────────────────── └─REMOTESYSTEM(char4)─┬───────────────────┬──┘ └─REMOTENAME(char4)─┘ ┌─TASKLIMIT(NO)──────┐ ──┬─────────────────────┬──┼────────────────────┼───────────────────────── └─SECURITYNAME(char8)─┘ └─TASKLIMIT(1-32767)─┘ ┌─TERMPRIORITY( )─────┐ ──┼─────────────────────┼──┬────────────────────┬──TYPETERM(char8)──────── └─TERMPRIORITY( -255)─┘ └─TRANSACTION(char4)─┘ ──┬───────────────┬──┤ └─USERID(char8)─┘

CREATE TRANCLASS
──CREATE TRANCLASS(data-value)─────────────────────────────────────────── ────ATTRIBUTES(data-value)ATTRLEN(data-value)────

Conditions: ILLOGIC, INVREQ, LENGERR, NOTAUTH

110

CICS User’s Handbook

SPI syntax

CREATE TRANCLASS
TRANCLASS attributes: ├──┬─────────────────────┬──MAXACTIVE( -999)─────────────────────────────── └─DESCRIPTION(char58)─┘ ┌─PURGETHRESH(NO)────────┐ ──┼────────────────────────┼──┤ └─PURGETHRESH(1-1 )─┘

CREATE TRANSACTION
──CREATE TRANSACTION(data-value)───────────────────────────────────────── ────ATTRIBUTES(data-value)ATTRLEN(data-value)────

Conditions: ILLOGIC, INVREQ, LENGERR, NOTAUTH

Chapter 2. SPI command syntax

111

SPI syntax

CREATE TRANSACTION
TRANSACTION attributes: ┌─ACTION(BACKOUT)─┐ ├──┼─────────────────┼──┬──────────────┬──┬───────────────┬──────────────── └─ACTION(COMMIT)──┘ └─ALIAS(char4)─┘ └─BREXIT(char8)─┘ ┌─CMDSEC(NO)──┐ ┌─CONFDATA(NO)──┐ ──┼─────────────┼──┼───────────────┼──┬─────────────────────┬───────────── └─CMDSEC(YES)─┘ └─CONFDATA(YES)─┘ └─DESCRIPTION(char58)─┘ ┌─DTIMOUT(NO)─────┐ ┌─DUMP(YES)─┐ ┌─DYNAMIC(NO)──┐ ──┼─────────────────┼──┼───────────┼──┼──────────────┼──────────────────── └─DTIMOUT(1-68 )─┘ └─DUMP(NO)──┘ └─DYNAMIC(YES)─┘ ┌─INDOUBT(BACKOUT)─┐ ┌─ISOLATE(YES)─┐ ┌─LOCALQ(NO)──┐ ──┼──────────────────┼──┼──────────────┼──┼─────────────┼───────────────── ├─INDOUBT(COMMIT)──┤ └─ISOLATE(NO)──┘ └─LOCALQ(YES)─┘ └─INDOUBT(WAIT)────┘ ┌─PRIORITY(1)─────┐ ┌─PROFILE(DFHCICST)─┐ ──┬─────────────────────┬──┼─────────────────┼──┼───────────────────┼───── ├─PARTITIONSET(char8)─┤ └─PRIORITY( -255)─┘ └─PROFILE(char8)────┘ ├─PARTITIONSET(KEEP)──┤ └─PARTITIONSET(OWN)───┘ ┌─RESSEC(NO)──┐ ──┬─PROGRAM(char8)─────────────────────────────┬──┼─────────────┼───────── └─REMOTESYSTEM(char4)─┬───────────────────┬──┘ └─RESSEC(YES)─┘ └─REMOTENAME(char8)─┘ ┌─RESTART(NO)──┐ ┌─RUNAWAY(SYSTEM)────┐ ┌─SHUTDOWN(DISABLED)─┐ ──┼──────────────┼──┼────────────────────┼──┼────────────────────┼──────── └─RESTART(YES)─┘ └─RUNAWAY( -27 )─┘ └─SHUTDOWN(ENABLED)──┘ ┌─SPURGE(NO)──┐ ┌─STATUS(ENABLED)──┐ ┌─STORAGECLEAR(NO)──┐ ──┼─────────────┼──┼──────────────────┼──┼───────────────────┼──────────── └─SPURGE(YES)─┘ └─STATUS(DISABLED)─┘ └─STORAGECLEAR(YES)─┘ ┌─TASKDATAKEY(USER)─┐ ┌─TASKDATALOC(BELOW)─┐ ──┼───────────────────┼──┼────────────────────┼──┬─────────────────┬────── └─TASKDATAKEY(CICS)─┘ └─TASKDATALOC(ANY)───┘ ├─TASKREQ(LPA)────┤ ├─TASKREQ(MSRE)───┤ ├─TASKREQ(OPID)───┤ ├─TASKREQ(PA1-3)──┤ └─TASKREQ(PF1-24)─┘ ┌─TPURGE(NO)──┐ ┌─TRACE(YES)─┐ ──┬─────────────────┬──┼─────────────┼──┼────────────┼──────────────────── ├─TPNAME(char64)──┤ └─TPURGE(YES)─┘ └─TRACE(NO)──┘ └─XTPNAME(hex128)─┘ ┌─TRANCLASS(DFHTCL )─┐ ┌─TRPROF(DFHCICSS)─┐ ┌─TWASIZE( )───────┐ ──┼─────────────────────┼──┼──────────────────┼──┼──────────────────┼───── └─TRANCLASS(char8)────┘ └─TRPROF(char8)────┘ └─TWASIZE( -32767)─┘ ┌─WAIT(YES)─┐ ┌─WAITTIME( , , )──────────┐ ──┼───────────┼──┼──────────────────────────┼──┬───────────────┬──┤ └─WAIT(NO)──┘ └─WAITTIME( -99, -23, -59)─┘ └─XTRANID(hex8)─┘

112

CICS User’s Handbook

SPI syntax

| | | |

CREATE TSMODEL
──CREATE TSMODEL(data-value)───────────────────────────────────────────── ────ATTRIBUTES(data-value)ATTRLEN(data-value)────

|

Conditions: ILLOGIC, INVREQ, LENGERR, NOTAUTH

| | | | | | | | | | | | | | |

CREATE TSMODEL
TSMODEL attributes: ┌─LOCATION(AUXILIARY)─┐ ├──┬─────────────────────┬──┼─────────────────────┼──────────────────────── └─DESCRIPTION(char58)─┘ └─LOCATION(MAIN)──────┘ ┌─RECOVERY(NO)──┐ ──┬─────────────────┬──┬─────────────────┬──┼───────────────┼───────────── └─POOLNAME(char8)─┘ ├─PREFIX(char16)──┤ └─RECOVERY(YES)─┘ └─XPREFIX(char32)─┘ ┌─SECURITY(NO)──┐ ──┬───────────────────────────────────────────────┬──┼───────────────┼──┤ └─REMOTESYSTEM(char4)─┬──────────────────────┬──┘ └─SECURITY(YES)─┘ ├─REMOTEPREFIX(char16)─┤ └─XREMOTEPFX(char32)───┘

CREATE TYPETERM
──CREATE TYPETERM(data-value)──ATTRIBUTES(data-value)──────────────────── ──ATTRLEN(data-value)──

Conditions: ILLOGIC, INVREQ, LENGERR, NOTAUTH

Chapter 2. SPI command syntax

113

SPI syntax

CREATE TYPETERM

TYPETERM attributes (1/3): ┌─ALTPAGE( , )─────────┐ ├──┼──────────────────────┼──┬────────────────────────┬──────────────────── └─ALTPAGE( -999, -999)─┘ └─ALTSCREEN( -999, -999)─┘ ┌─APLKYBD(NO)──┐ ┌─APLTEXT(NO)──┐ ──┬──────────────────┬──┼──────────────┼──┼──────────────┼──────────────── └─ALTSUFFIX(char1)─┘ └─APLKYBD(YES)─┘ └─APLTEXT(YES)─┘ ┌─ASCII(NO)─┐ ┌─ATI(NO)──┐ ┌─AUDIBLEALARM(NO)──┐ ──┼───────────┼──┼──────────┼──┼───────────────────┼────────────────────── ├─ASCII(7)──┤ └─ATI(YES)─┘ └─AUDIBLEALARM(YES)─┘ └─ASCII(8)──┘ ┌─AUTOCONNECT(NO)──┐ ┌─BACKTRANS(NO)──┐ ──┼──────────────────┼──┬───────────────┬──┼────────────────┼───────────── ├─AUTOCONNECT(ALL)─┤ ├─AUTOPAGE(NO)──┤ └─BACKTRANS(YES)─┘ └─AUTOCONNECT(YES)─┘ └─AUTOPAGE(YES)─┘ ┌─BRACKET(YES)─┐ ┌─BUILDCHAIN(NO)──┐ ┌─CGCSGID( , )─────────────┐ ──┼──────────────┼──┼─────────────────┼──┼──────────────────────────┼───── └─BRACKET(NO)──┘ └─BUILDCHAIN(YES)─┘ └─CGCSGID( -65535, -65535)─┘ ┌─COLOR(NO)──┐ ┌─COPY(NO)──┐ ┌─CREATESESS(NO)──┐ ──┼────────────┼──┼───────────┼──┼─────────────────┼────────────────────── └─COLOR(YES)─┘ └─COPY(YES)─┘ └─CREATESESS(YES)─┘ ┌─DEFSCREEN( , )─────────┐ ──┼────────────────────────┼──┬─────────────────────┬──DEVICE(char8)────── └─DEFSCREEN( -999, -999)─┘ └─DESCRIPTION(char58)─┘ ┌─DISCREQ(YES)─┐ ┌─DUALCASEKYBD(NO)──┐ ┌─ERRCOLOR(NO)────────┐ ──┼──────────────┼──┼───────────────────┼──┼─────────────────────┼──────── └─DISCREQ(NO)──┘ └─DUALCASEKYBD(YES)─┘ ├─ERRCOLOR(BLUE)──────┤ ├─ERRCOLOR(GREEN)─────┤ ├─ERRCOLOR(NEUTRAL)───┤ ├─ERRCOLOR(PINK)──────┤ ├─ERRCOLOR(RED)───────┤ ├─ERRCOLOR(TURQUOISE)─┤ └─ERRCOLOR(YELLOW)────┘ ┌─ERRHILIGHT(NO)────────┐ ┌─ERRINTENSIFY(NO)──┐ ──┼───────────────────────┼──┼───────────────────┼──────────────────────── ├─ERRHILIGHT(BLINK)─────┤ └─ERRINTENSIFY(YES)─┘ ├─ERRHILIGHT(REVERSE)───┤ └─ERRHILIGHT(UNDERLINE)─┘ ┌─ERRLASTLINE(NO)──┐ ┌─EXTENDEDDS(NO)──┐ ┌─FMHPARM(NO)──┐ ──┼──────────────────┼──┼─────────────────┼──┼──────────────┼───────────── └─ERRLASTLINE(YES)─┘ └─EXTENDEDDS(YES)─┘ └─FMHPARM(YES)─┘ ┌─FORMFEED(NO)──┐ ┌─HILIGHT(NO)──┐ ┌─HORIZFORM(NO)──┐ ──┼───────────────┼──┼──────────────┼──┼────────────────┼───────────────── └─FORMFEED(YES)─┘ └─HILIGHT(YES)─┘ └─HORIZFORM(YES)─┘ ┌─IOAREALEN( , )─────────────┐ ┌─KATAKANA(NO)──┐ ──┼────────────────────────────┼──┼───────────────┼──┤ └─IOAREALEN( -32767, -32767)─┘ └─KATAKANA(YES)─┘

114

CICS User’s Handbook

SPI syntax

CREATE TYPETERM

TYPETERM attributes (2/3): ┌─LIGHTPEN(NO)──┐ ├──┬────────────────┬──┼───────────────┼──┬────────────────┬─────────────── └─LDCLIST(char8)─┘ └─LIGHTPEN(YES)─┘ ├─LOGMODE(char8)─┤ └─LOGMODE( )─────┘ ┌─LOGONMSG(NO)──┐ ┌─MSRCONTROL(NO)──┐ ┌─NEPCLASS( )─────┐ ──┼───────────────┼──┼─────────────────┼──┼─────────────────┼───────────── └─LOGONMSG(YES)─┘ └─MSRCONTROL(YES)─┘ └─NEPCLASS( -255)─┘ ┌─OBFORMAT(NO)──┐ ┌─OBOPERID(NO)──┐ ┌─OUTLINE(NO)──┐ ──┼───────────────┼──┼───────────────┼──┼──────────────┼────────────────── └─OBFORMAT(YES)─┘ └─OBOPERID(YES)─┘ └─OUTLINE(YES)─┘ ┌─PAGESIZE(24,8 )───────┐ ┌─PARTITIONS(NO)──┐ ──┼───────────────────────┼──┼─────────────────┼────────────────────────── └─PAGESIZE( -999, -999)─┘ └─PARTITIONS(YES)─┘ ┌─PRINTADAPTER(NO)──┐ ┌─PROGSYMBOLS(NO)──┐ ┌─QUERY(NO)───┐ ──┼───────────────────┼──┼──────────────────┼──┼─────────────┼──────────── └─PRINTADAPTER(YES)─┘ └─PROGSYMBOLS(YES)─┘ ├─QUERY(ALL)──┤ └─QUERY(COLD)─┘ ┌─RECEIVESIZE(256)─────┐ ┌─RECOVNOTIFY(NONE)────────┐ ──┼──────────────────────┼──┼──────────────────────────┼────────────────── └─RECEIVESIZE( -3 72 )─┘ ├─RECOVNOTIFY(MESSAGE)─────┤ └─RECOVNOTIFY(TRANSACTION)─┘ ┌─RECOVOPTION(SYSDEFAULT)──┐ ┌─RELREQ(NO)──┐ ──┼──────────────────────────┼──┼─────────────┼─────────────────────────── ├─RECOVOPTION(CLEARCONV)───┤ └─RELREQ(YES)─┘ ├─RECOVOPTION(NONE)────────┤ ├─RECOVOPTION(RELEASESESS)─┤ └─RECOVOPTION(UNCONDREL)───┘ ┌─SENDSIZE( )───────┐ ──┬──────────────────────┬──┼───────────────────┼───────────────────────── ├─ROUTEDMSGS(ALL)──────┤ └─SENDSIZE( -3 72 )─┘ ├─ROUTEDMSGS(NONE)─────┤ └─ROUTEDMSGS(SPECIFIC)─┘ ┌─SHIPPABLE(NO)──┐ ┌─SIGNOFF(YES)────┐ ──┬────────────────────┬──┼────────────────┼──┼─────────────────┼───────── └─SESSIONTYPE(char8)─┘ └─SHIPPABLE(YES)─┘ ├─SIGNOFF(NO)─────┤ └─SIGNOFF(LOGOFF)─┘ ┌─SOSI(NO)──┐ ┌─TEXTKYBD(NO)──┐ ──┼───────────┼──┬──────────────┬──┼───────────────┼────────────────────── └─SOSI(YES)─┘ ├─TERMMODEL(1)─┤ └─TEXTKYBD(YES)─┘ └─TERMMODEL(2)─┘ ┌─TEXTPRINT(NO)──┐ ┌─TTI(YES)─┐ ┌─UCTRAN(NO)─────┐ ──┼────────────────┼──┼──────────┼──┼────────────────┼──────────────────── └─TEXTPRINT(YES)─┘ └─TTI(NO)──┘ ├─UCTRAN(TRANID)─┤ └─UCTRAN(YES)────┘ ┌─USERAREALEN( )─────┐ ┌─VALIDATION(NO)──┐ ──┼────────────────────┼──┼─────────────────┼──┤ └─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
──DISABLE PROGRAM(data-value)──┬───────────────────────┬───────────────── └─ENTRYNAME(data-value)─┘ ──┬──────────────────┬───┬───────────┬────┬──────────┬────┬─────┬───────── ├─EXIT(data-value)─┤ └─FORMATEDF─┘ └─SHUTDOWN─┘ └─SPI─┘ └─EXITALL──────────┘ ───┬──────┬────┬───────────┬─── └─STOP─┘ └─TASKSTART─┘

Conditions: INVEXITREQ, NOTAUTH

DISCARD AUTINSTMODEL
──DISCARD AUTINSTMODEL(data-value)──

Conditions: INVREQ, MODELIDERR, NOTAUTH

DISCARD CONNECTION
──DISCARD CONNECTION(data-value)──

Conditions: INVREQ, NOTAUTH, SYSIDERR

DISCARD DB2CONN
──DISCARD DB2CONN──

Conditions: INVREQ, NOTAUTH, NOTFND

116

CICS User’s Handbook

SPI syntax

DISCARD DB2ENTRY
──DISCARD DB2ENTRY(data-value)──

Conditions: NOTFND, INVREQ, NOTAUTH

DISCARD DB2TRAN
──DISCARD DB2TRAN(data-value)──

Conditions: NOTFND, NOTAUTH

DISCARD DOCTEMPLATE
──DISCARD DOCTEMPLATE(data-value)──

Conditions: NOTAUTH, NOTFND

| | |

DISCARD ENQMODEL
──DISCARD ENQMODEL(data-value)──

|

Conditions: NOTAUTH, NOTFND

DISCARD FILE
──DISCARD FILE(data-value)──

Conditions: FILENOTFOUND, INVREQ, NOTAUTH

Chapter 2. SPI command syntax

117

SPI syntax

DISCARD JOURNALMODEL
──DISCARD──JOURNALMODEL(data-value)──

Conditions: NOTAUTH, NOTFND

DISCARD JOURNALNAME
──DISCARD──JOURNALNAME(data-value)──

Conditions: INVREQ, JIDERR, NOTAUTH

DISCARD PARTNER
──DISCARD PARTNER(data-value)──

Conditions: INVREQ, NOTAUTH, PARTNERIDERR

DISCARD PROCESSTYPE
──DISCARD──PROCESSTYPE(data-value)──

Conditions: INVREQ, NOTAUTH, PROCESSERR

DISCARD PROFILE
──DISCARD PROFILE(data-value)──

Conditions: INVREQ, NOTAUTH, PROFILEIDERR

118

CICS User’s Handbook

SPI syntax

DISCARD PROGRAM
──DISCARD PROGRAM(data-value)──

Conditions: INVREQ, NOTAUTH, PGMIDERR

DISCARD REQUESTMODEL
──DISCARD──REQUESTMODEL(data-value)──

Conditions: NOTAUTH, NOTFND

DISCARD TCPIPSERVICE
──DISCARD TCPIPSERVICE(data-value)──

Conditions: INVREQ, NOTAUTH, NOTFND

DISCARD TDQUEUE
──DISCARD TDQUEUE(data-value)──

Conditions: INVREQ, NOTAUTH, QIDERR

DISCARD TERMINAL
──DISCARD TERMINAL(data-value)──

Conditions: INVREQ, NOTAUTH, TERMIDERR

Chapter 2. SPI command syntax

119

SPI syntax

DISCARD TRANCLASS
──DISCARD TRANCLASS(data-value)──

Conditions: INVREQ, NOTAUTH, TCIDERR

DISCARD TRANSACTION
──DISCARD TRANSACTION(data-value)──

Conditions: INVREQ, NOTAUTH, TRANSIDERR

| | |

DISCARD TSMODEL
──DISCARD TSMODEL(data-value)──

|

Conditions: INVREQ, NOTAUTH, NOTFND

ENABLE PROGRAM
┌── ───────────────────────────────┐ ──ENABLE PROGRAM(data-value)───┬─────────────────────────────┬┴── ├─ENTRY(ptr-ref)──────────────┤ ├─ENTRYNAME(data-value)───────┤ ├─EXIT(data-value)────────────┤ ├─FORMATEDF───────────────────┤ ├─┬─GALENGTH(data-value)────┬─┤ │ └─GAENTRYNAME(data-value)─┘ │ ├─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
──EXTRACT EXIT PROGRAM(data-value)──┬───────────────────────┬──────────── └─ENTRYNAME(data-value)─┘ ──GALENGTH(data-area)──GASET(ptr-ref)──

Conditions: INVEXITREQ, NOTAUTH

INQUIRE AUTINSTMODEL
──INQUIRE AUTINSTMODEL(data-value)──

Conditions: END, ILLOGIC, MODELIDERR, NOTAUTH

INQUIRE AUTOINSTALL
| ┌── ──────────────────────┐ ──INQUIRE AUTOINSTALL───┬────────────────────┬┴── ├─CONSOLES(cvda)─────┤ ├─CURREQS(data-area)─┤ ├─ENABLESTATUS(cvda)─┤ ├─MAXREQS(data-area)─┤ └─PROGRAM(data-area)─┘

|

Conditions: NOTAUTH

INQUIRE CFDTPOOL
──INQUIRE CFDTPOOL(data-value)──┬──────────────────┬── └─CONNSTATUS(cvda)─┘

Conditions: END, ILLOGIC, NOTAUTH, POOLERR

Chapter 2. SPI command syntax

121

SPI syntax

INQUIRE CONNECTION
┌── ───────────────────────────┐ ──INQUIRE CONNECTION(data-value)───┬─────────────────────────┬┴── ├─ACCESSMETHOD(cvda)──────┤ ├─ACQSTATUS(cvda)─────────┤ ├─AUTOCONNECT(cvda)───────┤ ├─CONNSTATUS(cvda)────────┤ ├─CONNTYPE(cvda)──────────┤ ├─CQP(cvda)───────────────┤ ├─EXITTRACING(cvda)───────┤ ├─GRNAME(data-area)───────┤ ├─LINKSYSTEM(data-area)───┤ ├─MEMBERNAME(data-area)───┤ ├─NETNAME(data-area)──────┤ ├─PENDSTATUS(cvda)────────┤ ├─PROTOCOL(cvda)──────────┤ ├─RECEIVECOUNT(data-area)─┤ ├─RECOVSTATUS(cvda)───────┤ ├─REMOTENAME(data-area)───┤ ├─REMOTESYSNET(data-area)─┤ ├─REMOTESYSTEM(data-area)─┤ ├─SENDCOUNT(data-area)────┤ ├─SERVSTATUS(cvda)────────┤ ├─XLNSTATUS(cvda)─────────┤ └─ZCPTRACING(cvda)────────┘

|

Conditions: END, ILLOGIC, NOTAUTH, SYSIDERR

122

CICS User’s Handbook

SPI syntax

INQUIRE DB2CONN
──INQUIRE DB2CONN──────────────────────────────────────────────────────── ┌── ───────────────────────────┐ ┌── ───────────────────────────┐ ───┬─────────────────────────┬┴───┬─────────────────────────┬┴── ├─┬─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
──INQUIRE DB2ENTRY(data-value)──┬──────────────────┬───────────────────── ├─ACCOUNTREC(cvda)─┤ ├─UOW──────────────┤ ├─TASK─────────────┤ ├─TXID─────────────┤ └─NONE─────────────┘ ──┬───────────────────┬──┬────────────────┬──┬───────────────────┬──────── └─AUTHID(data-area)─┘ ├─AUTHTYPE(cvda)─┤ ├─DISABLEDACT(cvda)─┤ ├─GROUP──────────┤ ├─ABEND─────────────┤ ├─SIGN───────────┤ ├─SQLCODE───────────┤ ├─TERM───────────┤ └─POOL──────────────┘ ├─TX─────────────┤ ├─OPID───────────┤ └─USERID─────────┘ ──┬─────────────────┬──┬────────────────────┬──┬─────────────────┬──────── ├─DROLLBACK(cvda)─┤ ├─ENABLESTATUS(cvda)─┤ └─PLAN(data-area)─┘ ├─ROLLBACK────────┤ ├─ENABLED────────────┤ └─NOROLLBACK──────┘ ├─DISABLED───────────┤ └─DISABLING──────────┘ ──┬─────────────────────────┬──┬────────────────┬───────────────────────── └─PLANEXITNAME(data-area)─┘ ├─PRIORITY(cvda)─┤ ├─HIGH───────────┤ ├─EQUAL──────────┤ └─LOW────────────┘ ──┬───────────────────────┬──┬─────────────────────┬────────────────────── └─PROTECTNUM(data-area)─┘ └─PTHREADS(data-area)─┘ ──┬────────────────────────┬──┬────────────────────┬────────────────────── └─THREADLIMIT(data-area)─┘ └─THREADS(data-area)─┘ ──┬──────────────────┬── ├─THREADWAIT(cvda)─┤ ├─TWAIT────────────┤ ├─NOTWAIT──────────┤ └─TPOOL────────────┘

Conditions: END,ILLOGIC,NOTAUTH, NOTFND

INQUIRE DB2TRAN
──INQUIRE DB2TRAN──┬──────────────┬──┬─────────────────────┬───────────── └─(data-value)─┘ └─DB2ENTRY(data-area)─┘ ──┬────────────────────┬── └─TRANSID(data-area)─┘

Conditions: END,ILLOGIC,NOTAUTH, NOTFND

124

CICS User’s Handbook

SPI syntax

INQUIRE DELETSHIPPED
──INQUIRE DELETSHIPPED─────────────────────────────────────────────────── ──┬──────────────────────────────────────────────────────────────┬──────── ├─IDLE(data-area)──────────────────────────────────────────────┤ └─IDLEHRS(data-area)──IDLEMINS(data-area)──IDLESECS(data-area)─┘ ──┬──────────┬── ├─┤ INQ7 ├─┤ └─┤ INQ8 ├─┘ INQ7: ├──INTERVAL(data-area)──┤ INQ8: ├──┤ INQ9 ├──INTERVALMINS(data-area)──INTERVALSECS(data-area)──┤ INQ9: ├──INTERVALHRS(data-area)──┤

Conditions: NOTAUTH

INQUIRE DOCTEMPLATE
┌── ───────────────────────────┐ ──INQUIRE DOCTEMPLATE(data-value)───┬─────────────────────────┬┴── ├─APPENDCRLF(cvda)────────┤ ├─DDNAME(data-area)───────┤ ├─DSNAME(data-area)───────┤ ├─EXITPGM(data-area)──────┤ ├─FILE(data-area)─────────┤ ├─MEMBER(data-area)───────┤ ├─PROGRAM(data-area)──────┤ ├─TDQUEUE(data-area)──────┤ ├─TEMPLATENAME(data-area)─┤ ├─TEMPLATETYPE(cvda)──────┤ ├─TSQUEUE(data-area)──────┤ └─TYPE(cvda)──────────────┘

Conditions: END, ILLOGIC, NOTFND, NOTAUTH

Chapter 2. SPI command syntax

125

SPI syntax

INQUIRE DSNAME
┌── ──────────────────────────┐ ──INQUIRE DSNAME(data-value)───┬────────────────────────┬┴── ├─ACCESSMETHOD(cvda)─────┤ ├─AVAILABILITY(cvda)─────┤ ├─BACKUPTYPE(cvda)───────┤ ├─BASEDSNAME(data-area)──┤ ├─FILECOUNT(data-area)───┤ ├─FWDRECOVLOG(data-area)─┤ ├─FWDRECOVLSN(data-area)─┤ ├─OBJECT(cvda)───────────┤ ├─LOSTLOCKS(cvda)────────┤ ├─QUIESCESTATE(cvda)─────┤ ├─RECOVSTATUS(cvda)──────┤ ├─RETLOCKS(cvda)─────────┤ └─VALIDITY(cvda)─────────┘

Conditions: DSNNOTFOUND, END, ILLOGIC, IOERR, NOTAUTH

INQUIRE DUMPDS
┌── ─────────────────────────┐ ──INQUIRE DUMPDS───┬───────────────────────┬┴── ├─CURRENTDDS(data-area)─┤ ├─INITIALDDS(data-area)─┤ ├─OPENSTATUS(cvda)──────┤ └─SWITCHSTATUS(cvda)────┘

Conditions: NOTAUTH

126

CICS User’s Handbook

SPI syntax

| | | | | | | | | | | | | | | | | | | |

INQUIRE ENQ
──INQUIRE ENQ──┬─ENQSCOPE(data-value)───────────────────┬──────────────── ├─RESOURCE(data-value)RESLEN(data-value)─┤ └─UOW(data-value)────────────────────────┘ ┌── ────────────────────────┐ ───┬──────────────────────┬┴── ├─DURATION(data-area)──┤ ├─ENQFAILS(data-area)──┤ ├─NETUOWID(data-area)──┤ ├─QUALIFIER(data-area)─┤ ├─QUALLEN(data-area)───┤ ├─RELATION(cvda)───────┤ ├─RESLEN(data-area)────┤ ├─RESOURCE(data-area)──┤ ├─STATE(cvda)──────────┤ ├─TASKID(data-area)────┤ ├─TRANSID(data-area)───┤ ├─TYPE(cvda)───────────┤ └─UOW(data-area)───────┘

|

Conditions: END, ILLOGIC, NOTAUTH, UOWNOTFOUND

| | | | | | |

INQUIRE ENQMODEL
┌── ───────────────────────┐ ──INQUIRE ENQMODEL(data-value)───┬─────────────────────┬┴── ├─ENQSCOPE(data-area)─┤ ├─ENQNAME(data-area)──┤ └─STATUS(cvda)────────┘

|

Conditions: END, ILLOGIC, NOTAUTH, NOTFND

INQUIRE EXCI
──INQUIRE EXCI──┬──────────────────┬── ├─TASK(data-value)─┤ └─URID(data-value)─┘

Conditions: END, ILLOGIC, NOTAUTH

Chapter 2. SPI command syntax

127

SPI syntax

INQUIRE EXITPROGRAM
┌── ────────────────────────────┐ ──INQUIRE EXITPROGRAM(data-value)───┬──────────────────────────┬┴── ├─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
┌── ───────────────────────────┐ ──INQUIRE FILE(data-value)───┬─────────────────────────┬┴── ├─ACCESSMETHOD(cvda)──────┤ ├─ADD(cvda)───────────────┤ ├─BASEDSNAME(data-area)───┤ ├─BLOCKFORMAT(cvda)───────┤ ├─BLOCKKEYLEN(data-area)──┤ ├─BLOCKSIZE(data-area)────┤ ├─BROWSE(cvda)────────────┤ ├─CFDTPOOL(data-area)─────┤ ├─DELETE(cvda)────────────┤ ├─DISPOSITION(cvda)───────┤ ├─DSNAME(data-area)───────┤ ├─EMPTYSTATUS(cvda)───────┤ ├─ENABLESTATUS(cvda)──────┤ ├─EXCLUSIVE(cvda)─────────┤ ├─FWDRECSTATUS(cvda)──────┤ ├─JOURNALNUM(data-area)───┤ ├─KEYLENGTH(data-area)────┤ ├─KEYPOSITION(data-area)──┤ ├─LOADTYPE(cvda)──────────┤ ├─LSRPOOLID(data-area)────┤ ├─MAXNUMRECS(data-area)───┤ ├─OBJECT(cvda)────────────┤ ├─OPENSTATUS(cvda)────────┤ ├─READ(cvda)──────────────┤ ├─READINTEG(cvda)─────────┤ ├─RECORDFORMAT(cvda)──────┤ ├─RECORDSIZE(data-area)───┤ ├─RECOVSTATUS(cvda)───────┤ ├─RELTYPE(cvda)───────────┤ ├─REMOTENAME(data-area)───┤ ├─REMOTESYSTEM(data-area)─┤ ├─REMOTETABLE(cvda)───────┤ ├─RLSACCESS(cvda)─────────┤ ├─STRINGS(data-area)──────┤ ├─TABLE(cvda)─────────────┤ ├─TABLENAME(data-area)────┤ ├─TYPE(cvda)──────────────┤ ├─UPDATE(cvda)────────────┤ └─UPDATEMODEL(cvda)───────┘

|

|

|

| |

Conditions: END, FILENOTFOUND, ILLOGIC, NOTAUTH

INQUIRE IRC
──INQUIRE IRC──┬──────────────────┬── └─OPENSTATUS(cvda)─┘

Conditions: NOTAUTH

Chapter 2. SPI command syntax

129

SPI syntax

INQUIRE JOURNALMODEL
──INQUIRE JOURNALMODEL(data-value)──┬────────────────────────┬─────────── └─JOURNALNAME(data-area)─┘ ──┬───────────────────────┬──┬────────────┬── └─STREAMNAME(data-area)─┘ └─TYPE(cvda)─┘

Conditions: END, ILLOGIC, NOTAUTH, NOTFND

INQUIRE JOURNALNAME
┌── ─────────────────────────┐ ──INQUIRE JOURNALNAME(data-value)───┬───────────────────────┬┴── ├─STATUS(cvda)──────────┤ ├─STREAMNAME(data-area)─┤ └─TYPE(cvda)────────────┘

Conditions: END, ILLOGIC, JIDERR, NOTAUTH

INQUIRE MODENAME
──INQUIRE MODENAME(data-value)──CONNECTION(data-value)─────────────────── ┌── ─────────────────────────┐ ───┬───────────────────────┬┴── ├─ACTIVE(data-area)─────┤ ├─AUTOCONNECT(cvda)─────┤ ├─AVAILABLE(data-area)──┤ ├─MAXIMUM(data-area)────┤ └─MAXWINNERS(data-area)─┘

Conditions: END, ILLOGIC, NOTAUTH, SYSIDERR

130

CICS User’s Handbook

SPI syntax

INQUIRE MONITOR
┌── ───────────────────────────────────────────────┐ ──INQUIRE MONITOR───┬─────────────────────────────────────────────┬┴── ├─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
──INQUIRE NETNAME(data-value)──┬─────────────────────┬── └─TERMINAL(data-area)─┘

Conditions: NOTAUTH, TERMIDERR

INQUIRE PARTNER
┌── ────────────────────────┐ ──INQUIRE PARTNER(data-value)───┬──────────────────────┬┴── ├─NETWORK(data-area)───┤ ├─NETNAME(data-area)───┤ ├─PROFILE(data-area)───┤ ├─TPNAME(data-area)────┤ └─TPNAMELEN(data-area)─┘

Conditions: END, ILLOGIC, NOTAUTH, PARTNERIDERR

Chapter 2. SPI command syntax

131

SPI syntax

INQUIRE PROCESSTYPE
──INQUIRE──PROCESSTYPE(data-value)──┬─────────────────┬────────────────── └─FILE(data-area)─┘ ──┬─────────────────────┬──┬──────────────────┬──┬──────────────┬── └─AUDITLOG(data-area)─┘ └─AUDITLEVEL(cvda)─┘ └─STATUS(cvda)─┘

Conditions: NOTAUTH, PROCESSERR

INQUIRE PROFILE
──INQUIRE PROFILE(data-value)──

Conditions: END, ILLOGIC, NOTAUTH, PROFILEIDERR

INQUIRE PROGRAM
┌── ─────────────────────────────────────┐ ──INQUIRE PROGRAM(data-value)───┬───────────────────────────────────┬┴── ├─CEDFSTATUS(cvda)──────────────────┤ ├─COBOLTYPE(cvda)───────────────────┤ ├─COPY(cvda)────────────────────────┤ ├─CONCURRENCY(cvda)─────────────────┤ ├─DATALOCATION(cvda)────────────────┤ ├─DYNAMSTATUS(cvda)─────────────────┤ ├─ENTRYPOINT(ptr-ref)───────────────┤ ├─EXECKEY(cvda)─────────────────────┤ ├─EXECUTIONSET(cvda)────────────────┤ ├─HOLDSTATUS(cvda)──────────────────┤ ├─JVMCLASS(255-character data-area)─┤ ├─JVMDEBUG(cvda)────────────────────┤ ├─LANGDEDUCED(cvda)─────────────────┤ ├─LANGUAGE(cvda)────────────────────┤ ├─LENGTH(data-area)─────────────────┤ ├─LOADPOINT(ptr-ref)────────────────┤ ├─LPASTATUS(cvda)───────────────────┤ ├─PROGTYPE(cvda)────────────────────┤ ├─REMOTENAME(data-area)─────────────┤ ├─REMOTESYSTEM(data-area)───────────┤ ├─RESCOUNT(data-area)───────────────┤ ├─RUNTIME(cvda)─────────────────────┤ ├─SHARESTATUS(cvda)─────────────────┤ ├─STATUS(cvda)──────────────────────┤ ├─TRANSID(data-area)────────────────┤ └─USECOUNT(data-area)───────────────┘

| |

| |

|

Conditions: END, ILLOGIC, NOTAUTH, PGMIDERR

132

CICS User’s Handbook

SPI syntax

INQUIRE REQID
──INQUIRE REQID(data-value)──┬───────────────┬─────────────────────────── └─REQTYPE(cvda)─┘ ──┬───────────────────┬──┬────────────────────┬─────────────────────────── └─TERMID(data-area)─┘ └─TRANSID(data-area)─┘ ──┬─────────────────────────────────────────────────────────────────┬───── ├─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)────┘ ──┬──────────────────────────────────────────────────────┬──────────────── └─SET(ptr-ref)──LENGTH(data-area)──┬─────────────────┬─┘ └─FMHSTATUS(cvda)─┘ ──┬─────────────────────┬──┬────────────────────┬───────────────────────── └─RTRANSID(data-area)─┘ └─RTERMID(data-area)─┘ ──┬──────────────────┬──┬───────────────────┬── └─QUEUE(data-area)─┘ └─USERID(data-area)─┘

Conditions: END, ILLOGIC, INVREQ, NOTAUTH, NOTFND

INQUIRE REQUESTMODEL
┌── ───────────────────────────┐ ──INQUIRE REQUESTMODEL(data-value)───┬─────────────────────────┬┴── ├─OMGINTERFACE(data-area)─┤ ├─OMGMODULE(data-area)────┤ ├─OMGOPERATION(data-area)─┤ └─TRANSID(data-value)─────┘

Conditions: END, ILLOGIC, JIDERR, NOTAUTH

INQUIRE RRMS
──INQUIRE RRMS──┬──────────────────┬── └─OPENSTATUS(cvda)─┘

Conditions:

Chapter 2. SPI command syntax

133

SPI syntax

INQUIRE STATISTICS
──INQUIRE STATISTICS──┬──────────────────────────────────────┬─────────── ├─ENDOFDAY(data-area)──────────────────┤ └─┤ endhrs ├──┤ endmins ├──┤ endsecs ├─┘ ──┬───────────────────────────────────┬─────────────────────────────────── ├─INTERVAL(data-area)───────────────┤ └─┤ inhrs ├──┤ inmins ├──┤ insecs ├─┘ ──┬───────────────────────────────────┬──┬─────────────────┬── ├─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
──INQUIRE STORAGE──────────────────────────────────────────────────────── ──┬─ADDRESS(ptr-value)──┬──────────────────┬──┬────────────────────┬─┬── │ └─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
┌── ───────────────────────┐ ──INQUIRE STREAMNAME(data-value)───┬─────────────────────┬┴── ├─STATUS(cvda)────────┤ ├─SYSTEMLOG(cvda)─────┤ └─USECOUNT(data-area)─┘

Conditions: END, ILLOGIC, NOTAUTH, NOTFND

INQUIRE SYSDUMPCODE
┌── ──────────────────────┐ ──INQUIRE SYSDUMPCODE(data-value)───┬────────────────────┬┴── ├─CURRENT(data-area)─┤ ├─DAEOPTION(cvda)────┤ ├─DUMPSCOPE(cvda)────┤ ├─MAXIMUM(data-area)─┤ ├─SHUTOPTION(cvda)───┤ └─SYSDUMPING(cvda)───┘

Conditions: END, ILLOGIC, NOTAUTH, NOTFND

Chapter 2. SPI command syntax

135

SPI syntax

INQUIRE SYSTEM
| ┌── ────────────────────────────────────────────┐ ──INQUIRE SYSTEM───┬──────────────────────────────────────────┬┴── ├─ACTOPENTCBS(data-area)───────────────────┤ ├─AKP(data-area)───────────────────────────┤ ├─CDSASIZE(data-area)──────────────────────┤ ├─CICSSTATUS(cvda)─────────────────────────┤ ├─CICSSYS(data-area)───────────────────────┤ ├─CICSTSLEVEL(data-area)───────────────────┤ ├─CMDPROTECT(cvda)─────────────────────────┤ ├─COLDSTATUS(cvda)─────────────────────────┤ ├─DB2CONN(data-area)───────────────────────┤ ├─DFLTUSER(data-area)──────────────────────┤ ├─DSALIMIT(data-area)──────────────────────┤ ├─DSRTPROGRAM(data-area)───────────────────┤ ├─DTRPROGRAM(data-area)────────────────────┤ ├─DUMPING(cvda)────────────────────────────┤ ├─ECDSASIZE(data-area)─────────────────────┤ ├─EDSALIMIT(data-area)─────────────────────┤ ├─ERDSASIZE(data-area)─────────────────────┤ ├─ESDSASIZE(data-area)─────────────────────┤ ├─EUDSASIZE(data-area)─────────────────────┤ ├─FORCEQR(cvda)────────────────────────────┤ ├─GMMTEXT(data-area)──GMMLENGTH(data-area)─┤ ├─GMMTRANID(data-area)─────────────────────┤ ├─INITSTATUS(cvda)─────────────────────────┤ ├─JOBNAME(data-area)───────────────────────┤ ├─LOGDEFER(data-area)──────────────────────┤ ├─MAXOPENTCBS(data-area)───────────────────┤ ├─MAXTASKS(data-area)──────────────────────┤ ├─MROBATCH(data-area)──────────────────────┤ ├─OPREL(data-area)─────────────────────────┤ ├─OPSYS(data-area)─────────────────────────┤ ├─OSLEVEL(data-area)───────────────────────┤ ├─PROGAUTOCTLG(cvda)───────────────────────┤ ├─PROGAUTOEXIT(data-area)──────────────────┤ ├─PROGAUTOINST(cvda)───────────────────────┤ ├─PRTYAGING(data-area)─────────────────────┤ ├─RDSASIZE(data-area)──────────────────────┤ ├─REENTPROTECT(cvda)───────────────────────┤ ├─RELEASE(data-area)───────────────────────┤ ├─RLSSTATUS(cvda)──────────────────────────┤ ├─RUNAWAY(data-area)───────────────────────┤ ├─SCANDELAY(data-area)─────────────────────┤ ├─SDSASIZE(data-area)──────────────────────┤ ├─SDTRAN(data-area)────────────────────────┤ ├─SECURITYMGR(cvda)────────────────────────┤ ├─SHUTSTATUS(cvda)─────────────────────────┤ ├─SOSSTATUS(cvda)──────────────────────────┤ ├─STARTUP(cvda)────────────────────────────┤ ├─STARTUPDATE(data-area)───────────────────┤ ├─STOREPROTECT(cvda)───────────────────────┤ ├─TIME(data-area)──────────────────────────┤ ├─TRANISOLATE(cvda)────────────────────────┤ ├─UDSASIZE(data-area)──────────────────────┤ └─XRFSTATUS(cvda)──────────────────────────┘

|

|

| |

|

Condition: NOTAUTH

136

CICS User’s Handbook

SPI syntax

INQUIRE TASK
| | ┌── ───────────────────────────────┐ ──INQUIRE TASK(data-value)───┬─────────────────────────────┬┴── ├─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
──INQUIRE TASK LIST──LISTSIZE(data-area)───┬──────────────┬────────────── └─DISPATCHABLE─┘ ───┬─────────┬────┬───────────┬─────────────────────────────────────────── └─RUNNING─┘ └─SUSPENDED─┘ ──┬───────────────────────────────────────┬── └─SET(ptr-ref)──┬─────────────────────┬─┘ └─SETTRANSID(ptr-ref)─┘

Condition: NOTAUTH

INQUIRE TCLASS
┌── ──────────────────────┐ ──INQUIRE TCLASS(data-value)───┬────────────────────┬┴── ├─CURRENT(data-area)─┤ └─MAXIMUM(data-area)─┘

Conditions: NOTAUTH, TCIDERR

INQUIRE TCPIP
──INQUIRE TCPIP──OPENSTATUS(cvda)──

Conditions: INVREQ, NOTAUTH

138

CICS User’s Handbook

SPI syntax

INQUIRE TCPIPService
┌── ───────────────────────────┐ ──INQUIRE TCPIPSERVICE(data-value)───┬─────────────────────────┬┴── ├─BACKLOG(data-area)──────┤ ├─CLOSETIMEOUT(data-area)─┤ ├─CONNECTIONS(data-area)──┤ ├─IPADDRESS(data-area)────┤ ├─OPENSTATUS(cvda)────────┤ ├─PORT(data-area)─────────┤ ├─SOCKETCLOSE(cvda)───────┤ ├─SSLTYPE(cvda)───────────┤ ├─TRANSID(data-area)──────┤ ├─TSQPREFIX(data-area)────┤ └─URM(data-area)──────────┘

Conditions: INVREQ, NOTAUTH , NOTFND

INQUIRE TDQUEUE
┌── ───────────────────────────┐ ──INQUIRE TDQUEUE(data-value)───┬─────────────────────────┬┴── ├─ATIFACILITY(cvda)───────┤ ├─ATITERMID(data-area)────┤ ├─ATITRANID(data-area)────┤ ├─ATIUSERID(data-area)────┤ ├─BLOCKFORMAT(cvda)───────┤ ├─BLOCKSIZE(data-area)────┤ ├─DATABUFFERS(data-area)──┤ ├─DDNAME(data-area)───────┤ ├─DISPOSITION(cvda)───────┤ ├─DSNAME(data-area)───────┤ ├─EMPTYSTATUS(cvda)───────┤ ├─ENABLESTATUS(cvda)──────┤ ├─ERROROPTION(cvda)───────┤ ├─INDIRECTNAME(data-area)─┤ ├─INDOUBT(cvda)───────────┤ ├─INDOUBTWAIT(cvda)───────┤ ├─IOTYPE(cvda)────────────┤ ├─MEMBER(data-area)───────┤ ├─NUMITEMS(data-area)─────┤ ├─OPENSTATUS(cvda)────────┤ ├─PRINTCONTROL(cvda)──────┤ ├─RECORDFORMAT(cvda)──────┤ ├─RECORDLENGTH(data-area)─┤ ├─RECOVSTATUS(cvda)───────┤ ├─REMOTENAME(data-area)───┤ ├─REMOTESYSTEM(data-area)─┤ ├─REWIND(cvda)────────────┤ ├─SYSOUTCLASS(cvda)───────┤ ├─TRIGGERLEVEL(data-area)─┤ └─TYPE(cvda)──────────────┘

|

Conditions: ENDCOND, ILLOGIC, NORMAL, NOTAUTH, QIDERR

Chapter 2. SPI command syntax

139

SPI syntax

INQUIRE TERMINAL/NETNAME
──INQUIRE TERMINAL(data-value)──┬────────────────────┬── └─NETNAME(data-area)─┘

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

INQUIRE TERMINAL
┌── ─────────────────────────┐ ───┬───────────────────────┬┴── ├─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
┌── ───────────────────────────┐ ───┬─────────────────────────┬┴── ├─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
┌── ────────────────────────┐ ──INQUIRE TRACEDEST───┬──────────────────────┬┴── ├─AUXSTATUS(cvda)──────┤ ├─CURAUXDS(data-area)──┤ ├─GTFSTATUS(cvda)──────┤ ├─INTSTATUS(cvda)──────┤ ├─SWITCHSTATUS(cvda)───┤ └─TABLESIZE(data-area)─┘

Conditions: NOTAUTH

INQUIRE TRACEFLAG
┌── ──────────────────────┐ ──INQUIRE TRACEFLAG───┬────────────────────┬┴── ├─SINGLESTATUS(cvda)─┤ ├─SYSTEMSTATUS(cvda)─┤ ├─TCEXITSTATUS(cvda)─┤ └─USERSTATUS(cvda)───┘

Conditions: NOTAUTH

INQUIRE TRACETYPE
┌── ─────────────────────┐ ──INQUIRE TRACETYPE──┬─STANDARD─┬───┬───────────────────┬┴── └─SPECIAL──┘ └─COMPID(data-area)─┘

Conditions: NOTAUTH, NOTFND

INQUIRE TRANCLASS
┌── ──────────────────────────┐ ──INQUIRE TRANCLASS(data-value)───┬────────────────────────┬┴── ├─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
┌── ──────────────────────┐ ──INQUIRE TRANDUMPCODE(data-value)───┬────────────────────┬┴── ├─CURRENT(data-area)─┤ ├─DUMPSCOPE(cvda)────┤ ├─MAXIMUM(data-area)─┤ ├─SHUTOPTION(cvda)───┤ ├─SYSDUMPING(cvda)───┤ └─TRANDUMPING(cvda)──┘

Conditions: END, ILLOGIC, NOTAUTH, NOTFND

INQUIRE TRANSACTION
┌── ────────────────────────────┐ ──INQUIRE TRANSACTION(data-value)───┬──────────────────────────┬┴── ├─BREXIT(data-area)────────┤ ├─CMDSEC(cvda)─────────────┤ ├─DTIMEOUT(data-area)──────┤ ├─DUMPING(cvda)────────────┤ ├─FACILITYLIKE(data-area)──┤ ├─INDOUBT(cvda)────────────┤ ├─INDOUBTMINS(data-area)───┤ ├─INDOUBTWAIT(cvda)────────┤ ├─ISOLATEST(cvda)──────────┤ ├─PRIORITY(data-area)──────┤ ├─PROFILE(data-area)───────┤ ├─PROGRAM(data-area)───────┤ ├─PURGEABILITY(cvda)───────┤ ├─REMOTENAME(data-area)────┤ ├─REMOTESYSTEM(data-area)──┤ ├─RESSEC(cvda)─────────────┤ ├─ROUTING(cvda)────────────┤ ├─ROUTESTATUS(cvda)────────┤ ├─RTIMEOUT(data-area)──────┤ ├─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
┌── ───────────────────────────┐ ──INQUIRE ──TSMODEL(data-value)───┬─────────────────────────┬┴── ├─LOCATION(cvda)──────────┤ ├─POOLNAME(data-area)─────┤ ├─PREFIX(data-area)───────┤ ├─RECOVSTATUS(cvda)───────┤ ├─REMOTEPREFIX(data-area)─┤ ├─REMOTESYSTEM(data-area)─┤ └─SECURITYST(cvda)────────┘

|

Conditions: END, ILLOGIC, NOTAUTH, NOTFND

| | | |

INQUIRE TSPOOL
──INQUIRE ──TSPOOL(data-value)──┬──────────────────┬── └─CONNSTATUS(cvda)─┘

|

Conditions: END, ILLOGIC, NOTAUTH, NOTFND

INQUIRE TSQUEUE
| | ──INQUIRE ──┬─TSQUEUE(data-value)─┬──┬──────────────────────┬──────────── └─TSQNAME(data-value)─┘ ├─POOLNAME(data-value)─┤ └─SYSID(data-value)────┘ ┌── ──────────────────────────┐ ───┬────────────────────────┬┴── ├─FLENGTH(data-area)─────┤ ├─LASTUSEDINT(data-area)─┤ ├─LOCATION(cvda)─────────┤ ├─MAXITEMLEN(data-area)──┤ ├─MINITEMLEN(data-area)──┤ ├─NUMITEMS(data-area)────┤ ├─RECOVSTATUS(cvda)──────┤ └─TRANSID(data-area)─────┘

|

Conditions: END, ILLOGIC, INVREQ, NOTAUTH, POOLERR, QIDERR, SYSIDERR

144

CICS User’s Handbook

SPI syntax

INQUIRE UOW
┌── ───────────────────────┐ ──INQUIRE UOW(data-area)───┬─────────────────────┬┴── ├─AGE(data-area)──────┤ ├─LINK(data-area)─────┤ ├─NETNAME(data-area)──┤ ├─NETUOWID(data-area)─┤ ├─SYSID(data-area)────┤ ├─TASKID(data-area)───┤ ├─TERMID(data-area)───┤ ├─TRANSID(data-area)──┤ ├─UOWSTATE(cvda)──────┤ ├─USERID(data-area)───┤ ├─WAITCAUSE(cvda)─────┤ └─WAITSTATE(cvda)─────┘

Conditions: END, ILLOGIC, NOTAUTH, UOWNOTFOUND

INQUIRE UOWDSNFAIL
──INQUIRE UOWDSNFAIL──┬─────────────┬──DSNAME(data-area)───────────────── └─CAUSE(cvda)─┘ ──┬────────────────────┬──┬──────────────┬──┬─────────────────┬─────────── └─NETNAME(data-area)─┘ └─REASON(cvda)─┘ └─RLSACCESS(cvda)─┘ ──┬──────────────────┬──UOW(data-area)── └─SYSID(data-area)─┘

Conditions: END, ILLOGIC, NOTAUTH

Chapter 2. SPI command syntax

145

SPI syntax

INQUIRE UOWENQ
| | | | ┌── ──────────────────────────────────────────┐ ──INQUIRE UOWENQ───┬────────────────────────────────────────┬┴─────────── ├─ENQSCOPE(data-value)───────────────────┤ ├─RESOURCE(data-value)RESLEN(data-value)─┤ └─UOW(data-value)────────────────────────┘ ┌── ────────────────────────┐ ───┬──────────────────────┬┴── ├─DURATION(data-area)──┤ ├─ENQFAILS(data-area)──┤ ├─NETUOWID(data-area)──┤ ├─QUALIFIER(data-area)─┤ ├─QUALLEN(data-area)───┤ ├─RELATION(cvda)───────┤ ├─RESLEN(data-area)────┤ ├─RESOURCE(data-area)──┤ ├─STATE(cvda)──────────┤ ├─TASKID(data-area)────┤ ├─TRANSID(data-area)───┤ ├─TYPE(cvda)───────────┤ └─UOW(data-area)───────┘

|

Conditions: END, ILLOGIC, NOTAUTH, UOWNOTFOUND

INQUIRE UOWLINK
──INQUIRE UOWLINK(data-area)──┬─────────────────┬──────────────────────── └─LINK(data-area)─┘ ──┬─────────────────────┬──┬────────────────┬──┬────────────────────┬───── └─NETUOWID(data-area)─┘ ├─PROTOCOL(cvda)─┤ ├─RESYNCSTATUS(cvda)─┤ ├─APPC───────────┤ ├─COLD───────────────┤ ├─IRC────────────┤ ├─NOTAPPLIC──────────┤ ├─LU61───────────┤ ├─OK─────────────────┤ ├─NOTAPPLIC──────┤ ├─STARTING───────────┤ └─RRMS───────────┘ ├─UNAVAILABLE────────┤ └─UNCONNECTED────────┘ ──┬───────────────────┬──┬─────────────┬──┬──────────────────┬──────────── └─RMIQFY(data-area)─┘ ├─ROLE(cvda)──┤ └─SYSID(data-area)─┘ ├─COORDINATOR─┤ ├─SUBORDINATE─┤ └─UNKNOWN─────┘ | | ──┬────────────┬──┬────────────────┬──┬─────────────────┬── ├─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
┌── ───────────────────────────────────────────────┐ ──INQUIRE VTAM───┬─────────────────────────────────────────────┬┴── ├─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
┌── ─────────────────────────┐ ──INQUIRE WEB(data-area)───┬───────────────────────┬┴── ├─GARBAGEINT(data-area)─┤ └─TIMEOUTINT(data-area)─┘

Conditions: NOTAUTH

PERFORM DELETSHIPPED
──PERFORM DELETSHIPPED──

Conditions: NOTAUTH

Chapter 2. SPI command syntax

147

SPI syntax

PERFORM DUMP
──PERFORM DUMP DUMPCODE(data-value)────────────────────────────────────── ──┬───────────────────────────────────────────┬─────────────────────────── └─TITLE(data-area)──TITLELENGTH(data-value)─┘ ──┬──────────────────────────────────────────────┬──────────────────────── └─CALLER(data-value)──CALLERLENGTH(data-value)─┘ ──┬────────────────────┬── └─DUMPID(data-value)─┘

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

PERFORM ENDAFFINITY
──PERFORM ENDAFFINITY──NETNAME(data-value)──┬───────────────────┬── └─NETID(data-value)─┘

Conditions: INVREQ

PERFORM RESETTIME
──PERFORM RESETTIME──

Conditions: INVREQ, NOTAUTH

PERFORM SECURITY REBUILD
──PERFORM SECURITY REBUILD──┬────────────────────┬── └─ESMRESP(data-area)─┘

Conditions: INVREQ, IOERR, NORMAL, NOTAUTH, SYSBUSY

148

CICS User’s Handbook

SPI syntax

PERFORM SHUTDOWN
──PERFORM SHUTDOWN───┬──────┬───┬──────────────────────────────┬── └─DUMP─┘ ├─IMMEDIATE────────────────────┤ │ ┌── ──────────────────────────┐ │ └──┬────────────────────────┬┴─┘ ├─PLT(data-value)────────┤ ├─┬─SDTRAN(data-value)─┬─┤ │ └─NOSDTRAN───────────┘ │ ├─XLT(data-value)────────┤ └─TAKEOVER───────────────┘

Conditions: INVREQ, NOTAUTH, TRANSIDERR

PERFORM STATISTICS RECORD
┌── ─────────────────────┐ ──PERFORM STATISTICS RECORD───┬───────────────────┬┴── ├─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
──RESYNC ENTRYNAME(data-value)──┬───────────────────────┬──────────────── └─QUALIFIER(data-value)─┘ ──┬──────────────────────────────────────────────────┬──┬─────────┬── └─IDLIST(data-value)──┬──────────────────────────┬─┘ └─PARTIAL─┘ └─IDLISTLENGTH(data-value)─┘

Conditions: NOTAUTH

SET AUTOINSTALL
| ──SET AUTOINSTALL──┬────────────────┬──┬─────────────────────┬─────────── └─CONSOLES(cvda)─┘ └─MAXREQS(data-value)─┘ ──┬─────────────────────┬── └─PROGRAM(data-value)─┘

Conditions: INVREQ, NOTAUTH, PGMIDERR

SET CONNECTION
──SET CONNECTION(data-value)──┬──────────────────┬──┬────────────────┬─── ├─ACQSTATUS(cvda)──┤ ├─AFFINITY(cvda)─┤ ├─CONNSTATUS(cvda)─┤ └─ENDAFFINITY────┘ ├─ACQUIRED─────────┤ └─RELEASED─────────┘ ──┬───────────────────┬──┬──────────────────┬──┬─────────────────┬──────── ├─EXITTRACING(cvda)─┤ ├─PENDSTATUS(cvda)─┤ ├─PURGETYPE(cvda)─┤ ├─EXITTRACE─────────┤ └─NOTPENDING───────┘ ├─CANCEL──────────┤ └─NOEXITTRACE───────┘ ├─FORCECANCEL─────┤ ├─FORCEPURGE──────┤ └─PURGE───────────┘ ──┬───────────────────┬──┬──────────────────┬──┬─────────────────┬──────── ├─RECOVSTATUS(cvda)─┤ ├─SERVSTATUS(cvda)─┤ ├─UOWACTION(cvda)─┤ └─NORECOVDATA───────┘ ├─INSERVICE────────┤ ├─BACKOUT─────────┤ └─OUTSERVICE───────┘ ├─COMMIT──────────┤ ├─FORCE───────────┤ └─RESYNC──────────┘ ──┬──────────────────┬── ├─ZCPTRACING(cvda)─┤ ├─NOZCPTRACE───────┤ └─ZCPTRACE─────────┘

Conditions: INVREQ, IOERR, NORMAL, NOTAUTH, SYSIDERR

150

CICS User’s Handbook

SPI syntax

SET DB2CONN
──SET DB2CONN──────────────────────────────────────────────────────────── ┌── ───────────────────────────┐ ┌── ───────────────────────────┐ ───┬─────────────────────────┬┴───┬─────────────────────────┬┴── ├─┬─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

──SET DB2ENTRY──┬─────────────┬─────────────────────────────── └─(data-area)─┘ ┌── ───────────────────────────┐ ───┬─────────────────────────┬┴─────────────────────────────── ├─┬─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

┌── ───────────────────────┐ ──SET DB2TRAN───┬─────────────────────┬┴───────────────────── ├─DB2ENTRY(data-area)─┤ └─TRANSID(data-area)──┘ Conditions: NOTAUTH, NOTFND, INVREQ

SET DELETSHIPPED
──SET DELETSHIPPED──┬────────────────────────────┬─────────────────────── ├─IDLE(data-value)───────────┤ │ ┌── ────────────────────────┐ │ └──┬──────────────────────┬┴─┘ ├─IDLEHRS(data-value)──┤ ├─IDLEMINS(data-value)─┤ └─IDLESECS(data-value)─┘ ──┬────────────────────────────────┬── ├─INTERVAL(data-value)───────────┤ │ ┌── ────────────────────────────┐ │ └──┬──────────────────────────┬┴─┘ ├─INTERVALHRS(data-value)──┤ ├─INTERVALMINS(data-value)─┤ └─INTERVALSECS(data-value)─┘

Conditions: INVREQ, NOTAUTH

SET DSNAME
──SET DSNAME(data-value)──┬──────────────┬──┬────────────────────┬─────── ├─ACTION(cvda)─┤ ├─AVAILABILITY(cvda)─┤ ├─REMOVE───────┤ ├─AVAILABLE──────────┤ ├─RECOVERED────┤ └─UNAVAILABLE────────┘ ├─RESETLOCKS───┤ └─RETRY────────┘ ┌─WAIT───────┐ ──┬───────────────────┬──┼────────────┼──┬─────────────────┬── ├─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
──SET DUMPDS──┬────────────────────────┬──┬──────────────────┬─────────── └─INITIALDDS(data-value)─┘ ├─OPENSTATUS(cvda)─┤ ├─CLOSED───────────┤ ├─OPEN─────────────┤ └─SWITCH───────────┘ ──┬────────────────────┬── ├─SWITCHSTATUS(cvda)─┤ ├─NOSWITCH───────────┤ └─SWITCHNEXT─────────┘

Conditions: INVREQ, IOERR, NOTAUTH

| | | | |

SET ENQMODEL
──SET ENQMODEL(data-value)──┬─STATUS(cvda)─┬── ├─DISABLED─────┤ └─ENABLED──────┘

|

Conditions: INVREQ, NOTAUTH, NOTFND

SET FILE
──┬─SET FILE(data-value)────┬────ATTRIBUTES(data-value)──── └─SET DATASET(data-value)─┘

Conditions: FILENOTFOUND, INVREQ, IOERR, NOTAUTH

154

CICS User’s Handbook

SPI syntax

SET FILE
FILE attributes: ┌─WAIT───────┐ ├──┬────────────┬──┬──────────────┬──┼────────────┼──────────────────────── ├─ADD(cvda)──┤ ├─BROWSE(cvda)─┤ ├─BUSY(cvda)─┤ ├─ADDABLE────┤ ├─BROWSABLE────┤ ├─FORCE──────┤ └─NOTADDABLE─┘ └─NOTBROWSABLE─┘ └─NOWAIT─────┘ | ──┬──────────────────────┬──┬──────────────┬──┬───────────────────┬─────── └─CFDTPOOL(data-value)─┘ ├─DELETE(cvda)─┤ ├─DISPOSITION(cvda)─┤ ├─DELETABLE────┤ ├─OLD───────────────┤ └─NOTDELETABLE─┘ └─SHARE─────────────┘ ──┬────────────────────────┬──┬───────────────────┬─────────────────────── ├─DSNAME(data-value)─────┤ ├─EMPTYSTATUS(cvda)─┤ └─OBJECTNAME(data-value)─┘ ├─EMPTY─────────────┤ ├─EMPTYREQ──────────┤ └─NOEMPTYREQ────────┘ ┌── ──────────────────────────────┐ ───┬────────────────────────────┬┴──┬─────────────────┬─────────────────── └─┬─┬─ENABLESTATUS(cvda)─┬─┬─┘ ├─EXCLUSIVE(cvda)─┤ │ ├─DISABLED───────────┤ │ ├─EXCTL───────────┤ │ └─ENABLED────────────┘ │ └─NOEXCTL─────────┘ └─┬─OPENSTATUS(cvda)─┬───┘ ├─CLOSED───────────┤ └─OPEN─────────────┘ | | | ──┬───────────────────────┬──┬────────────────┬─────────────────────────── └─KEYLENGTH(data-value)─┘ ├─LOADTYPE(cvda)─┤ ├─LOAD───────────┤ └─NOLOAD─────────┘ ──┬───────────────────────┬──┬────────────────────────┬─────────────────── └─LSRPOOLID(data-value)─┘ └─MAXNUMRECS(data-value)─┘ | ──┬─────────────┬──┬────────────────────────┬──┬─────────────────┬──────── ├─READ(cvda)──┤ └─RECORDSIZE(data-value)─┘ ├─READINTEG(cvda)─┤ ├─NOTREADABLE─┤ ├─UNCOMMITTED─────┤ └─READABLE────┘ ├─CONSISTENT──────┤ └─REPEATABLE──────┘ ──┬─────────────────┬──┬─────────────────────┬──┬─────────────┬─────────── ├─RLSACCESS(cvda)─┤ └─STRINGS(data-value)─┘ ├─TABLE(cvda)─┤ ├─RLS─────────────┤ ├─CFTABLE─────┤ ├─NOTAPPLIC───────┤ ├─CICSTABLE───┤ └─NOTRLS──────────┘ ├─NOTTABLE────┤ └─USERTABLE───┘ ──┬───────────────────────┬──┬──────────────┬──┬───────────────────┬──┤ └─TABLENAME(data-value)─┘ ├─UPDATE(cvda)─┤ ├─UPDATEMODEL(cvda)─┤ ├─NOTUPDATABLE─┤ ├─CONTENTION────────┤ └─UPDATABLE────┘ └─LOCKING───────────┘

|

| | |

Chapter 2. SPI command syntax

155

SPI syntax

SET IRC
──SET IRC──┬──────────────────┬── ├─OPENSTATUS(cvda)─┤ ├─CLOSED───────────┤ ├─IMMCLOSE─────────┤ └─OPEN─────────────┘

Conditions: INVREQ, IOERR, NOSTG, NOTAUTH

SET JOURNALNAME
──SET JOURNALNAME(data-value)──┬─ACTION(cvda)─┬──┬─STATUS(cvda)─┬── ├─FLUSH────────┤ ├─DISABLED─────┤ └─RESET────────┘ └─ENABLED──────┘

Conditions: INVREQ, IOERR, JIDERR, NOTAUTH

SET MODENAME
──SET MODENAME(data-value)──CONNECTION(data-value)─────────────────────── ──┬────────────────────────────────────────────┬── ├─AVAILABLE(data-value)──┬─────────────────┬─┤ │ ├─ACQSTATUS(cvda)─┤ │ │ └─ACQUIRED────────┘ │ └─┬─ACQSTATUS(cvda)─┬────────────────────────┘ └─CLOSED──────────┘

Conditions: INVREQ, NOTAUTH, SYSIDERR

156

CICS User’s Handbook

SPI syntax

SET MONITOR
──SET MONITOR──┬──────────────────┬──┬──────────────────┬──────────────── ├─CONVERSEST(cvda)─┤ ├─EVENTCLASS(cvda)─┤ ├─CONVERSE─────────┤ ├─EVENT────────────┤ └─NOCONVERSE───────┘ └─NOEVENT──────────┘ ──┬───────────────────┬──┬──────────────────────────────────┬───────────── ├─EXCEPTCLASS(cvda)─┤ ├─FREQUENCY(data-value)────────────┤ ├─EXCEPT────────────┤ │ ┌── ──────────────────────────────┐ │ └─NOEXCEPT──────────┘ └───┬──────────────────────────┬─┴─┘ ├─FREQUENCYHRS(data-value)─┤ ├─FREQUENCYMIN(data-value)─┤ └─FREQUENCYSEC(data-value)─┘ ──┬─────────────────┬──┬──────────────┬──┬───────────────────┬── ├─PERFCLASS(cvda)─┤ ├─STATUS(cvda)─┤ ├─SYNCPOINTST(cvda)─┤ ├─PERF────────────┤ ├─ON───────────┤ ├─SYNCPOINT─────────┤ └─NOPERF──────────┘ └─OFF──────────┘ └─NOSYNCPOINT───────┘

| |

Conditions: INVREQ, NOTAUTH

SET NETNAME
──SET NETNAME(data-value)──┬───────────────────┬── ├─EXITTRACING(cvda)─┤ ├─EXITTRACE─────────┤ └─NOEXITTRACE───────┘

Conditions: INVREQ, NOTAUTH

SET PROCESSTYPE
──SET──PROCESSTYPE(data-value)──┬──────────────┬──┬──────────────────┬── ├─STATUS(cvda)─┤ ├─AUDITLEVEL(cvda)─┤ ├─DISABLED─────┤ ├─ACTIVITY─────────┤ └─ENABLED──────┘ ├─FULL─────────────┤ ├─OFF──────────────┤ └─PROCESS──────────┘

Conditions: INVREQ, NOTAUTH, PROCESSERR

Chapter 2. SPI command syntax

157

SPI syntax

SET PROGRAM
──SET PROGRAM(data-value)──┬──────────────────┬──┬────────────┬────────── ├─CEDFSTATUS(cvda)─┤ ├─COPY(cvda)─┤ ├─CEDF─────────────┤ ├─NEWCOPY────┤ └─NOCEDF───────────┘ └─PHASEIN────┘ ──┬────────────────────┬──┬───────────────────┬─────────────────────────── ├─EXECUTIONSET(cvda)─┤ ├─SHARESTATUS(cvda)─┤ ├─DPLSUBSET──────────┤ ├─PRIVATE───────────┤ └─FULLAPI────────────┘ └─SHARED────────────┘ | | | | | | ──┬───────────────────────────────────┬──┬────────────────┬─────────────── └─JVMCLASS(255-character data-area)─┘ ├─JVMDEBUG(cvda)─┤ ├─DEBUG──────────┤ └─NODEBUG────────┘ ──┬───────────────┬──┬──────────────┬──┬───────────────┬── ├─RUNTIME(cvda)─┤ ├─STATUS(cvda)─┤ └─VERSION(cvda)─┘ ├─JVM───────────┤ ├─DISABLED─────┤ └─NOJVM─────────┘ └─ENABLED──────┘

Conditions: INVREQ, IOERROR, NOTAUTH, PGMIDERR

SET STATISTICS
──SET STATISTICS──┬────────────────────────────────┬───────────────────── ├─ENDOFDAY(data-value)───────────┤ │ ┌── ────────────────────────────┐ │ └──┬──────────────────────────┬┴─┘ ├─ENDOFDAYHRS(data-value)──┤ ├─ENDOFDAYMINS(data-value)─┤ └─ENDOFDAYSECS(data-value)─┘ ──┬────────────────────────────────┬────────────────────────────────────── ├─INTERVAL(data-value)───────────┤ │ ┌── ────────────────────────────┐ │ └──┬──────────────────────────┬┴─┘ ├─INTERVALHRS(data-value)──┤ ├─INTERVALMINS(data-value)─┤ └─INTERVALSECS(data-value)─┘ ──┬──────────────────────────────────────────────────┬── └─┬─RECORDING(cvda)─┬──┬───────────┬──┬──────────┬─┘ ├─ON──────────────┤ └─RECORDNOW─┘ └─RESETNOW─┘ └─OFF─────────────┘

Conditions: INVREQ, NOTAUTH

158

CICS User’s Handbook

SPI syntax

SET SYSDUMPCODE
──SET SYSDUMPCODE(data-value)──┬──────────────┬──┬─────────────────┬───── ├─ACTION(cvda)─┤ ├─DAEOPTION(cvda)─┤ ├─ADD──────────┤ ├─DAE─────────────┤ ├─REMOVE───────┤ └─NODAE───────────┘ └─RESET────────┘ ──┬─────────────────┬──┬─────────────────────┬──┬──────────────────┬────── ├─DUMPSCOPE(cvda)─┤ └─MAXIMUM(data-value)─┘ ├─SHUTOPTION(cvda)─┤ ├─LOCAL───────────┤ ├─NOSHUTDOWN───────┤ └─RELATED─────────┘ └─SHUTDOWN─────────┘ ──┬──────────────────┬── ├─SYSDUMPING(cvda)─┤ ├─NOSYSDUMP────────┤ └─SYSDUMP──────────┘

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

SET SYSTEM
┌── ────────────────────────────────────────────────────┐ ──SET SYSTEM───┬──────────────────────────────────────────────────┬┴── ├─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
──SET TASK(data-value)──┬──────────────────────┬──┬─────────────────┬── └─PRIORITY(data-value)─┘ ├─PURGETYPE(cvda)─┤ ├─FORCEPURGE──────┤ └─PURGE───────────┘

Conditions: INVREQ, NOTAUTH, TASKIDERR

SET TCLASS
──SET TCLASS(data-value)──┬─────────────────────┬── └─MAXIMUM(data-value)─┘

Conditions: INVREQ, NOTAUTH, TCIDERR

SET TCPIP
──SET TCPIP──┬─STATUS(data-value)─┬── ├─CLOSE──────────────┤ ├─IMMCLOSE───────────┤ └─OPEN───────────────┘

Conditions: INVREQ, IOERR, NOTAUTH

SET TCPIPSERVICE
──SET TCPIPSERVICE(data-value)──┬──────────────┬──┬─────────────────┬── ├─STATUS(cvda)─┤ └─URM(data-value)─┘ ├─CLOSE────────┤ ├─IMMCLOSE─────┤ └─OPEN─────────┘

Conditions: INVREQ, NOTAUTH, NOTFND

160

CICS User’s Handbook

SPI syntax

SET TDQUEUE
──SET TDQUEUE(data-value)──┬───────────────────┬───────────────────────── ├─ATIFACILITY(cvda)─┤ ├─NOTERMINAL────────┤ └─TERMINAL──────────┘ ──┬───────────────────────┬──┬───────────────────────┬──────────────────── └─ATITERMID(data-value)─┘ └─ATITRANID(data-value)─┘ ──┬───────────────────────┬──┬────────────────────┬─────────────────────── └─ATIUSERID(data-value)─┘ ├─ENABLESTATUS(cvda)─┤ ├─DISABLED───────────┤ └─ENABLED────────────┘ ──┬──────────────────┬──┬──────────────────────────┬── ├─OPENSTATUS(cvda)─┤ └─TRIGGERLEVEL(data-value)─┘ ├─CLOSED───────────┤ └─OPEN─────────────┘

Conditions: INVREQ, IOERR, NOTAUTH, QIDERR, USERIDERR

Chapter 2. SPI command syntax

161

SPI syntax

SET TERMINAL
──SET TERMINAL(data-value)──┬──────────────────┬───────────────────────── ├─ACQSTATUS(cvda)──┤ ├─TERMSTATUS(cvda)─┤ ├─ACQUIRED─────────┤ ├─COLDACQ──────────┤ └─RELEASED─────────┘ ──┬────────────────────────┬──┬────────────────────┬────────────────────── └─ALTPRINTER(data-value)─┘ ├─ALTPRTCOPYST(cvda)─┤ ├─ALTPRTCOPY─────────┤ └─NOALTPRTCOPY───────┘ ──┬─────────────────┬──┬──────────────────┬──┬─────────────────┬────────── ├─ATISTATUS(cvda)─┤ ├─CREATESESS(cvda)─┤ ├─DISCREQST(cvda)─┤ ├─ATI─────────────┤ ├─CREATE───────────┤ ├─DISCREQ─────────┤ └─NOATI───────────┘ └─NOCREATE─────────┘ └─NODISCREQ───────┘ ──┬───────────────────┬──┬─────────────────────┬────────────────────────── ├─EXITTRACING(cvda)─┤ └─MAPNAME(data-value)─┘ ├─EXITTRACE─────────┤ └─NOEXITTRACE───────┘ ──┬────────────────────────┬──┬─────────────────────────┬───────────────── └─MAPSETNAME(data-value)─┘ └─NEXTTRANSID(data-value)─┘ ──┬──────────────────┬──┬────────────────────┬──┬──────────────────┬────── ├─OBFORMATST(cvda)─┤ └─OPERID(data-value)─┘ ├─PAGESTATUS(cvda)─┤ ├─OBFORMAT─────────┤ ├─AUTOPAGEABLE─────┤ └─NOOBFORMAT───────┘ └─PAGEABLE─────────┘ ──┬─────────────────────┬──┬─────────────────┬──┬──────────────────┬────── └─PRINTER(data-value)─┘ ├─PRTCOPYST(cvda)─┤ ├─PURGETYPE(cvda)──┤ ├─PRTCOPY─────────┤ ├─FORCEPURGE───────┤ └─NOPRTCOPY───────┘ ├─PURGE──┬───────┬─┤ │ └─FORCE─┘ │ └─CANCEL───────────┘ ──┬────────────────┬──┬──────────────────┬──────────────────────────────── ├─RELREQST(cvda)─┤ ├─SERVSTATUS(cvda)─┤ ├─RELREQ─────────┤ ├─INSERVICE────────┤ └─NORELREQ───────┘ └─OUTSERVICE───────┘ ──┬─────────────────────────┬──┬──────────────────────────┬─────────────── └─TCAMCONTROL(data-value)─┘ └─TERMPRIORITY(data-value)─┘ ──┬───────────────┬──┬─────────────────┬──┬────────────────┬────────────── ├─TRACING(cvda)─┤ ├─TTISTATUS(cvda)─┤ ├─UCTRANST(cvda)─┤ ├─SPECTRACE─────┤ ├─NOTTI───────────┤ ├─UCTRAN─────────┤ └─STANTRACE─────┘ └─TTI─────────────┘ ├─NOUCTRAN───────┤ └─TRANIDONLY─────┘ ──┬──────────────────┬── ├─ZCPTRACING(cvda)─┤ ├─NOZCPTRACE───────┤ └─ZCPTRACE─────────┘

Conditions: INVREQ, NORMAL, NOTAUTH, TERMIDERR

162

CICS User’s Handbook

SPI syntax

SET TRACEDEST
──SET TRACEDEST──┬─────────────────┬──┬─────────────────┬──────────────── ├─AUXSTATUS(cvda)─┤ ├─GTFSTATUS(cvda)─┤ ├─AUXPAUSE────────┤ ├─GTFSTART────────┤ ├─AUXSTART────────┤ └─GTFSTOP─────────┘ └─AUXSTOP─────────┘ ──┬─────────────────┬──┬────────────────────┬──┬────────────────────┬───── ├─INTSTATUS(cvda)─┤ ├─SWITCHACTION(cvda)─┤ ├─SWITCHSTATUS(cvda)─┤ ├─INTSTART────────┤ └─SWITCH─────────────┘ ├─NOSWITCH───────────┤ └─INTSTOP─────────┘ ├─SWITCHALL──────────┤ └─SWITCHNEXT─────────┘ ──┬───────────────────────┬── └─TABLESIZE(data-value)─┘

Conditions: INVREQ, IOERR, NOSPACE, NOSTG, NOTAUTH

SET TRACEFLAG
──SET TRACEFLAG──┬────────────────────┬──┬────────────────────┬────────── ├─SINGLESTATUS(cvda)─┤ ├─SYSTEMSTATUS(cvda)─┤ ├─SINGLEOFF──────────┤ ├─SYSTEMOFF──────────┤ └─SINGLEON───────────┘ └─SYSTEMON───────────┘ ──┬────────────────────┬──┬──────────────────┬── ├─TCEXITSTATUS(cvda)─┤ ├─USERSTATUS(cvda)─┤ ├─TCEXITALL──────────┤ ├─USEROFF──────────┤ ├─TCEXITALLOFF───────┤ └─USERON───────────┘ ├─TCEXITNONE─────────┤ └─TCEXITSYSTEM───────┘

Conditions: INVREQ, NOTAUTH

SET TRACETYPE
┌── ──────────────────────┐ ──SET TRACETYPE──┬─STANDARD─┬───┬────────────────────┬┴── └─SPECIAL──┘ └─COMPID(data-value)─┘

Conditions: NOTAUTH, NOTFND

Chapter 2. SPI command syntax

163

SPI syntax

SET TRANCLASS
──SET TRANCLASS(data-value)──┬───────────────────────┬─────────────────── └─MAXACTIVE(data-value)─┘ ──┬─────────────────────────┬── └─PURGETHRESH(data-value)─┘

Conditions: INVREQ, NOTAUTH, TCIDERR

SET TRANDUMPCODE
──SET TRANDUMPCODE(data-value)──┬──────────────┬──┬─────────────────┬──── ├─ACTION(cvda)─┤ ├─DUMPSCOPE(cvda)─┤ ├─ADD──────────┤ ├─LOCAL───────────┤ ├─REMOVE───────┤ └─RELATED─────────┘ └─RESET────────┘ ──┬─────────────────────┬──┬──────────────────┬──┬──────────────────┬───── └─MAXIMUM(data-value)─┘ ├─SHUTOPTION(cvda)─┤ ├─SYSDUMPING(cvda)─┤ ├─NOSHUTDOWN───────┤ ├─NOSYSDUMP────────┤ └─SHUTDOWN─────────┘ └─SYSDUMP──────────┘ ──┬───────────────────┬── ├─TRANDUMPING(cvda)─┤ ├─NOTRANDUMP────────┤ └─TRANDUMP──────────┘

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

164

CICS User’s Handbook

SPI syntax

SET TRANSACTION
──SET TRANSACTION(data-value)──┬───────────────┬───────────────────────── ├─DUMPING(cvda)─┤ ├─TRANDUMP──────┤ └─NOTRANDUMP────┘ ──┬──────────────────────┬──┬────────────────────┬──────────────────────── └─PRIORITY(data-value)─┘ ├─PURGEABILITY(cvda)─┤ ├─NOTPURGEABLE───────┤ └─PURGEABLE──────────┘ ──┬─────────────────────┬──┬───────────────────┬──┬────────────────┬────── └─RUNAWAY(data-value)─┘ ├─RUNAWAYTYPE(cvda)─┤ ├─SHUTDOWN(cvda)─┤ ├─SYSTEM────────────┤ ├─SHUTDISABLED───┤ └─USER──────────────┘ └─SHUTENABLED────┘ ──┬──────────────┬──┬───────────────────────┬──┬───────────────┬── ├─STATUS(cvda)─┤ ├─TCLASS(data-value)────┤ ├─TRACING(cvda)─┤ ├─DISABLED─────┤ └─TRANCLASS(data-value)─┘ ├─SPECTRACE─────┤ └─ENABLED──────┘ ├─SPRSTRACE─────┤ └─STANTRACE─────┘

Conditions: INVREQ, NOTAUTH, TRANSIDERR

| | | | | | | | |

SET TSQUEUE
──SET ──┬─TSQUEUE(data-value)─┬──┬──────────────────────┬──────────────── └─TSQNAME(data-value)─┘ ├─SYSID(data-value)────┤ └─POOLNAME(data-value)─┘ ──┬───────────────────────────────────────────┬── ├─ACTION(cvda)─┬─────────────────────────┬──┤ │ └─LASTUSEDINT(data-value)─┘ │ └─DELETE────────────────────────────────────┘

| |

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

SET UOW
──SET UOW(data-value)──┬─UOWSTATE(cvda)─┬── ├─COMMIT─────────┤ ├─BACKOUT────────┤ └─FORCE──────────┘

Conditions: INVREQ, NOTAUTH, UOWNOTFOUND

Chapter 2. SPI command syntax

165

SPI syntax

SET UOWLINK
──SET UOWLINK(data-value)──┬──────────────┬── ├─ACTION(cvda)─┤ └─DELETE───────┘

Conditions: INVREQ, NOTAUTH, UOWLNOTFOUND

SET VTAM
──SET VTAM──┬──────────────────┬──┬──────────────────────────────┬─────── ├─OPENSTATUS(cvda)─┤ ├─PSDINTERVAL(data-value)──────┤ ├─CLOSED───────────┤ │ ┌── ──────────────────────────┐ │ ├─FORCECLOSE───────┤ └──┬────────────────────────┬┴─┘ ├─IMMCLOSE─────────┤ ├─PSDINTHRS(data-value)──┤ └─OPEN─────────────┘ ├─PSDINTMINS(data-value)─┤ └─PSDINTSECS(data-value)─┘ ──┬──────────────┬── └─DEREGISTERED─┘

Conditions: INVREQ, IOERR, NOTAUTH

SET WEB
──SET WEB──┬────────────────────────┬──┬────────────────────────┬── └─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 be entered on the command line. Menus are provided wherever the transaction name appears on its own in the syntax descriptions on the pages that follow. CEBT INQUIRE AUXTRACE
──CEBT Inquire Auxtrace──

CEBT INQUIRE DUMP
──CEBT Inquire Dump──

CEBT INQUIRE INTTRACE
──CEBT Inquire Inttrace──

CEBT INQUIRE GTFTRACE
──CEBT Inquire Gtftrace──

CEBT INQUIRE SURVEILLANCE
──CEBT Inquire Surveillance──

CEBT PERFORM SHUTDOWN
──CEBT Perform SHutdown──Dump──Immediate──

CEBT PERFORM SNAP
──CEBT Perform SNap──

CEBT PERFORM TAKEOVER
──CEBT Perform Takeover──Dump──

CEBT SET AUXTRACE
──CEBT Set Auxtrace──┬───────┬──┬──────────┬──SWitch── ├─STArt─┤ ├─NOswitch─┤ ├─Pause─┤ ├─NExt─────┤ └─STOp──┘ └─All──────┘

© Copyright IBM Corp. 1989, 1999

167

CST syntax

CEBT SET DUMP
──CEBT Set Dump──┬────────┬──┬──────────────┬── ├─Open───┤ ├─Autoswitch───┤ ├─CLosed─┤ └─Noautoswitch─┘ └─Switch─┘

CEBT SET GTFTRACE
──CEBT Set Gtftrace──┬───────┬── ├─STArt─┤ └─STOp──┘

CEBT SET INTTRACE
──CEbt Set Inttrace──┬───────┬── ├─STArt─┤ └─STOp──┘

CEBT SET SURVEILLANCE
──CEBT Set Surveillance──┬─────┬── ├─OFf─┤ └─ON──┘

CEBT SET TAKEOVER
──CEBT Set Takeover──┬───────────┬── ├─Automatic─┤ ├─Command───┤ └─Manual────┘

168

CICS User’s Handbook

CST syntax

──CEDA──┬─ADD──GROUP──LIST──┬────────┬──────────────────────────────────────────┬──── │ ├─AFTER──┤ │ │ └─BEFORE─┘ │ ├─ALTER──┤ Resource type ├──────────────────────────────────────────────┤ ├─APPEND──LIST──TO──────────────────────────────────────────────────────┤ ├─CHECK──┬─GROUP─┬──┬──────────────┬────────────────────────────────────┤ │ └─LIST──┘ └─REMOTESYSTEM─┘ │ │ ┌─ALL───────────────┐ │ ├─COPY──┼───────────────────┼──GROUP──┬─AS───┬──┬─────────┬─────────────┤ │ └─┤ Resource type ├─┘ ├─TO───┤ ├─REPLACE─┤ │ │ └─ASTO─┘ └─MERGE───┘ │ (1) ──────────────┤ ├─DEFINE──┤ Resource type ├──GROUP──┤ attribute list ├──── ├─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──┘ │ (1) ├─USERDEFINE──┤ Resource type ├──GROUP──┤ attribute list ├──────────────┤ └─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──┐ ──CEDF──┬───────────┬──┼──────┼── ├─termid────┤ └─,OFF─┘ ├─sysid─────┤ └─sessionid─┘

CEDX
┌─,ON──┐ ──CEDX──tranid──┼──────┼── └─,OFF─┘

170

CICS User’s Handbook

CST syntax

CEMT DISCARD
┌── ───────────────────────┐ ──CEMT Discard───┬─────────────────────┬┴── ├─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
──CEMT Inquire AUTInstmodel───┬─────┬─── └─All─┘

CEMT INQUIRE AUTOINSTALL
──CEMT Inquire AUTOinstall──

CEMT INQUIRE AUXTRACE
──CEMT Inquire AUXtrace──

Chapter 3. CICS-Supplied Transaction

171

CST syntax

CEMT INQUIRE CONNECTION
──CEMT Inquire Connection──┬─(value)─┬──┬────────────────┬──┬────────────┬─── └─ALl─────┘ └─NEtname(value)─┘ ├─NOTPending─┤ └─PEnding────┘ | | | | ──┬────────────┬──┬───────────┬──┬──────────────┬──┬─────────────┬──────────── ├─INService──┤ ├─ACquired──┤ ├─NOTSupported─┤ ├─Vtam────────┤ └─OUtservice─┘ ├─RELeased──┤ ├─Unattempted──┤ ├─IRc─────────┤ ├─OBtaining─┤ ├─COMPlete─────┤ ├─XM──────────┤ ├─FReeing───┤ └─Failed───────┘ ├─INDirect────┤ └─AVailable─┘ ├─XCf─────────┤ └─RConnection─┘ ──┬──────┬──┬──────────┬──┬─────────────┬──┬───────────────┬────────────────── ├─EXci─┤ ├─XOk──────┤ ├─RECovdata───┤ └─Grname(value)─┘ ├─APpc─┤ └─XNotdone─┘ ├─NORecovdata─┤ └─Lu61─┘ └─NRs─────────┘ ──┬───────────────────┬──┬─────────────────────┬──┬──────────────┬──────────── └─Membername(value)─┘ └─REMotesystem(value)─┘ └─RNAme(value)─┘ ──┬─────────────────┬── └─RNEtname(value)─┘

CEMT INQUIRE DB2CONN
──CEMT Inquire DB2Conn──

172

CICS User’s Handbook

CST syntax

──CEMT Inquire DB2Entry(data-area)──┬───────────────┬──┬───────┬─────────── └─AT(data-area)─┘ ├─START─┤ ├─END───┤ └─NEXT──┘ ──┬──────────────────┬──┬───────────────────┬──┬────────────────┬─────────── ├─ACCOUNTREC(cvda)─┤ └─AUTHID(data-area)─┘ ├─AUTHTYPE(cvda)─┤ ├─UOW──────────────┤ ├─GROUP──────────┤ ├─TASK─────────────┤ ├─SIGN───────────┤ ├─TXID─────────────┤ ├─TERM───────────┤ └─NONE─────────────┘ ├─TX─────────────┤ ├─OPID───────────┤ └─USERID─────────┘ ──┬───────────────────┬──┬─────────────────┬──┬────────────────────┬──────── ├─DISABLEDACT(cvda)─┤ ├─DROLLBACK(cvda)─┤ ├─ENABLESTATUS(cvda)─┤ ├─ABEND─────────────┤ ├─ROLLBACK────────┤ ├─ENABLED────────────┤ ├─SQLCODE───────────┤ └─NOROLLBACK──────┘ ├─DISABLED───────────┤ └─POOL──────────────┘ └─DISABLING──────────┘ ──┬─────────────────┬──┬─────────────────────────┬──┬────────────────┬────── └─PLAN(data-area)─┘ └─PLANEXITNAME(data-area)─┘ ├─PRIORITY(cvda)─┤ ├─HIGH───────────┤ ├─EQUAL──────────┤ └─LOW────────────┘ ──┬───────────────────────┬──┬─────────────────────┬──────────────────────── └─PROTECTNUM(data-area)─┘ └─PTHREADS(data-area)─┘ ──┬────────────────────────┬──┬────────────────────┬──────────────────────── └─THREADLIMIT(data-area)─┘ └─THREADS(data-area)─┘ ──┬──────────────────┬───────────────────────────────────────────────────── ├─THREADWAIT(cvda)─┤ ├─TWAIT────────────┤ ├─NOTWAIT──────────┤ └─TPOOL────────────┘

CEMT INQUIRE DB2TRAN
──CEMT Inquire DB2Tran──┬─────────────┬──┬─────────────────────┬───────────── └─(data-area)─┘ └─DB2Entry(data-area)─┘ ──┬────────────────────┬── └─Transid(data-area)─┘

CEMT INQUIRE DELETSHIPPED
──CEMT Inquire DEletshipped──┬─────────────┬──┬─────────────────┬── └─IDle(value)─┘ └─INterval(value)─┘

Chapter 3. CICS-Supplied Transaction

173

CST syntax

CEMT INQUIRE DOCTEMPLATE
──CEMT Inquire DOctemplate──┬─────────┬──┬────────────┬──┬──────────┬──────── ├─TSq─────┤ └─Name(name)─┘ ├─Append───┤ ├─TDq─────┤ └─Noappend─┘ ├─File────┤ ├─EXitpgm─┤ └─Member──┘ ──┬────────┬──┬────────────────────┬──┬──────────────────────────┬──────────── ├─Ebcdic─┤ └─Templatename(name)─┘ └─Templatename──(──name──)─┘ └─Binary─┘ ──┬────────┬── ├─DDname─┤ └─DSname─┘

CEMT INQUIRE DSAS
──CEMT Inquire DSAs──

CEMT INQUIRE DSNAME
┌─ALl────────────────┐ ──CEMT Inquire DSName──┼────────────────────┼── ├─(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
──CEMT Inquire DUmpds──

174

CICS User’s Handbook

CST syntax
| | | | | | | | | | | | | | |

CEMT INQUIRE ENQ
──CEMT Inquire Enq──┬────────────┬──┬────────────────┬──┬───────────────┬──── └─Uow(value)─┘ └─TRansid(value)─┘ └─TAskid(value)─┘ ──┬──────────┬──┬─────────────┬──┬────────┬──┬─────────────────┬────────────── ├─ACtive───┤ ├─Dataset─────┤ ├─Owner──┤ └─Netuowid(value)─┘ └─RETained─┘ ├─File────────┤ └─Waiter─┘ ├─EXecenq─────┤ ├─ADdrexecenq─┤ ├─TDq─────────┤ └─TSq─────────┘ ──┬─────────────────┬──┬─────────────────┬──┬─────────────┬─────────────────── └─ENqfails(value)─┘ └─RESource(value)─┘ └─RLen(value)─┘ ──┬──────────────────┬──┬─────────────┬── └─QUalifier(value)─┘ └─QLen(value)─┘

| | | | | |

CEMT INQUIRE ENQMODEL
──CEMT Inquire ENQModel──┬─(value)─────────┬──┬──────────┬── ├─ENQSCOPE(value)─┤ ├─DISABLED─┤ └─ENQNAME(value)──┘ ├─ENABLED──┤ └─WAITING──┘

CEMT INQUIRE EXCI
| ──CEMT Inquire Exci──┬──────────────┬── ├─Task(number)─┤ └─Urid(value)──┘

CEMT INQUIRE FILE
┌─ALl─────┐ ──CEMT Inquire FIle──┼─────────┼──┬────────┬──┬────────┬──┬───────────┬────── └─(value)─┘ ├─Vsam───┤ ├─OPen───┤ ├─ENabled───┤ ├─BDam───┤ └─CLosed─┘ ├─UNenabled─┤ └─REMote─┘ └─DIsabled──┘ ──┬────────┬──┬──────────┬──┬───────────┬──┬──────────┬──┬──────────┬───────── ├─REAd───┤ ├─UPdate───┤ ├─ADdable───┤ ├─BRowse───┤ ├─DElete───┤ └─NORead─┘ └─NOUpdate─┘ └─NOAddable─┘ └─NOBrowse─┘ └─NODelete─┘ ──┬─────────────┬──┬───────┬──┬────────┬──┬────────────┬────────────────────── ├─EXclusive───┤ ├─OLd───┤ ├─RLs────┤ ├─EMptyreq───┤ └─NOEXclusive─┘ └─Share─┘ └─NOTRls─┘ └─NOEMptyreq─┘ | | | | | | | ──┬───────────────┬──┬───────────┬──┬────────┬──┬─────────────────┬─────────── └─DSname(value)─┘ ├─NOTTable──┤ ├─LOAd───┤ └─CFDtpool(value)─┘ ├─CIcstable─┤ └─NOLoad─┘ ├─USertable─┤ └─CFTable───┘ ──┬──────────────────┬──┬────────────┬──┬───────────────────┬───────────────── └─Tablename(value)─┘ ├─LOCKING────┤ └─Maxnumrecs(value)─┘ └─COntention─┘ ──┬──────────────────┬──┬───────────────────┬── └─Keylength(value)─┘ └─RECordsize(value)─┘

CEMT INQUIRE GTFTRACE
──CEMT Inquire Gtftrace──

Chapter 3. CICS-Supplied Transaction

175

CST syntax

CEMT INQUIRE INTTRACE
──CEMT Inquire INttrace──

CEMT INQUIRE IRC
──CEMT Inquire IRc──

CEMT INQUIRE JMODEL
┌─All─────┐ ──CEMT Inquire JModel──┼─────────┼──┬────────────────────┬──┬───────┬──────── └─(value)─┘ └─(Journalnamevalue)─┘ ├─Mvs───┤ ├─SMf───┤ └─Dummy─┘ ──┬───────────────────┬── └─STreamname(value)─┘

CEMT INQUIRE JOURNALNAME
┌─All─────┐ ──CEMT Inquire JOurnalname──┴─(value)─┴──┬───────┬──┬──────────┬───────────── ├─Mvs───┤ ├─Enabled──┤ ├─SMf───┤ ├─DIsabled─┤ └─DUmmy─┘ └─FAiled───┘ ──┬───────────────────┬── └─STreamname(value)─┘

CEMT INQUIRE LINE
──CEMT Inquire Line──(value)──┬───────────────┬──┬────────────────┬────────── └─NUmber(value)─┘ └─NEgpoll(value)─┘ ──┬────────────┬── ├─Inservice──┤ └─Outservice─┘

CEMT INQUIRE MODENAME
┌─ALl─┐ ──CEMT Inquire MODename───┴─────┴───┬─────────┬──┬───────────────────┬─────── └─(value)─┘ └─COnnection(value)─┘ ──┬────────────────┬──┬──────────────────┬──┬───────────────┬── └─Maximum(value)─┘ └─AVailable(value)─┘ └─ACTive(value)─┘

CEMT INQUIRE MONITOR
──CEMT Inquire MONitor──┬───────┬──┬────────────────────┬── ├─Gmt───┤ └─SUbsystemid(value)─┘ └─Local─┘

176

CICS User’s Handbook

CST syntax

CEMT INQUIRE NETNAME
┌─ALl─────┐ ──CEMT Inquire Netname──┼─────────┼──┬────────────────────┬────────────────── └─(value)─┘ └─TRansaction(value)─┘ ──┬─────────────────┬──┬──────────────┬──┬────────────┬──┬───────┬──────────── └─PRiority(value)─┘ ├─PAgeable─────┤ ├─Inservice──┤ ├─ATi───┤ └─AUtopageable─┘ └─Outservice─┘ └─NOAti─┘ ──┬───────┬──┬───────────┬──┬─────────────────┬──┬──────────┬───────────────── ├─TTi───┤ ├─RTerminal─┤ └─TErminal(value)─┘ ├─ACquired─┤ └─NOTti─┘ ├─RSession──┤ ├─COldacq──┤ ├─Session───┤ └─RELeased─┘ └─Local─────┘ ──┬──────────┬──┬─────────────┬──┬─────────────────────┬──┬──────────────┬──── ├─CReate───┤ └─TAsk(value)─┘ └─REMotesystem(value)─┘ └─RNAme(value)─┘ └─NOCreate─┘ ──┬─────────────────┬──┬────────────┬───┬────────┬─── └─RNEtname(value)─┘ └─CId(value)─┘ └─Userid─┘

CEMT INQUIRE PARTNER
┌─All─────┐ ──CEMT Inquire PArtner──┼─────────┼──┬────────────────┬────────────────────── └─(value)─┘ └─NETWork(value)─┘ ──┬────────────────┬──┬────────────────┬──┬────────────────┬────────────────── └─NETName(value)─┘ └─Profile(value)─┘ └─Ltpname(value)─┘ ──┬───────────────┬── └─Tpname(value)─┘

CEMT INQUIRE PROCESSTYPE
┌─ALl─────┐ ──CEMT Inquire PROCesstype──┼─────────┼──┬─────────────┬───────────────────── └─(value)─┘ └─FIle(value)─┘ ──┬─────────────────┬──┬──────────┬──┬──────────┬── └─AUditlog(value)─┘ ├─ACtivity─┤ ├─Enabled──┤ ├─FUll─────┤ └─Disabled─┘ ├─Off──────┤ └─Process──┘

CEMT INQUIRE PROFILE
┌─All─────┐ ──CEMT Inquire PROFile──┼─────────┼── └─(value)─┘

Chapter 3. CICS-Supplied Transaction

177

CST syntax

CEMT INQUIRE PROGRAM
┌─ALl──────────┐ ──CEMT Inquire PROGram──┼──────────────┼──┬───────────────┬────────────────── ├─(value)──────┤ └─LENgth(value)─┘ └─CLass(value)─┘ ┌─PRIvate─┐ ──┬────────────┬──┬──────────────┬──┬──────────┬──┼─────────┼───────────────── ├─PLi────────┤ ├─PROgram──────┤ ├─Enabled──┤ └─Shared──┘ ├─CObol──────┤ ├─Mapset───────┤ └─DIsabled─┘ ├─C──────────┤ └─PArtitionset─┘ ├─LE37 ──────┤ ├─ASsembler──┤ ├─NOTDEfined─┤ └─JAVA───────┘ ──┬─────────────┬──┬────────┬──┬────────────┬──┬─────────────────┬──────────── ├─REQuired────┤ ├─CEDf───┤ ├─DYnamic────┤ └─REScount(value)─┘ └─NOTRequired─┘ └─NOCedf─┘ └─NOTDYnamic─┘ ──┬─────────────────┬──┬───────┬──┬──────────┬──┬───────────┬───────────────── └─USecount(value)─┘ ├─ANy───┤ ├─CEXeckey─┤ ├─DPlsubset─┤ └─Below─┘ └─UExeckey─┘ └─Fullapi───┘ | | | | | ──┬────────────┬──┬─────────────────────┬──┬──────────┬──┬─────────┬────────── ├─Quasirent──┤ └─REMotesystem(value)─┘ ├─JVM──────┤ ├─DEBug───┤ └─Threadsafe─┘ ├─LE37 ────┤ └─NODebug─┘ ├─NONLE37 ─┤ └─UNKNOWN──┘ ──┬─────────────────┬── └─JVMClass(value)─┘

| | |

CEMT INQUIRE STATISTICS
──CEMT Inquire STAtistics──

CEMT INQUIRE STREAMNAME
┌─ALl─┐ ──CEMT Inquire STReamname───┴─────┴─────(value)────┬─────────────────┬─────── └─Usecount(value)─┘ ──┬────────┬──┬──────────┬── ├─Failed─┤ ├─Syslog───┤ └─Ok─────┘ └─Nosyslog─┘

CEMT INQUIRE SYDUMPCODE
┌─ALl─────┐ ──CEMT Inquire SYDumpcode──┼─────────┼──┬───────────┬──┬─────────┬─────────── └─(value)─┘ ├─SYsdump───┤ ├─RELated─┤ └─NOSYsdump─┘ └─Local───┘ ──┬────────────┬──┬────────────────┬──┬────────────────┬──┬───────┬── ├─SHutdown───┤ └─Maximum(value)─┘ └─Current(value)─┘ ├─Dae───┤ └─NOSHutdown─┘ └─NODae─┘

CEMT INQUIRE SYSTEM
──CEMT Inquire SYStem──

178

CICS User’s Handbook

CST syntax

CEMT INQUIRE TASK
┌─ALl───────────┐ ──CEMT Inquire TAsk──┼───────────────┼──┬───────────────┬──────────────────── ├─(value)───────┤ └─TRanid(value)─┘ └─TClass(value)─┘ ──┬─────────────────┬──┬──────────────┬──┬──────┬──┬─────────────────┬──────── └─FAcility(value)─┘ ├─Running──────┤ ├─TAsk─┤ └─PRiority(value)─┘ ├─DIspatchable─┤ ├─TErm─┤ └─SUspended────┘ └─DEst─┘ ──┬──────────────────┬──┬───────────────┬──┬────────────┬───────────────────── └─STartcode(value)─┘ └─USerid(value)─┘ └─UOw(value)─┘ ──┬──────────────┬──┬───────────────┬──┬──────────────┬──┬─────────┬────────── └─HTYpe(value)─┘ └─HValue(value)─┘ └─HTIme(value)─┘ ├─Backout─┤ └─Commit──┘ ──┬───────────────┬──┬───────────────────┬──┬────────────────────┬──────────── └─BRidge(value)─┘ └─IDentifier(value)─┘ └─Indoubtmins(value)─┘ | ──┬────────┬──┬────────────────┬──┬───────────────────┬─────────────────────── ├─Nowait─┤ └─DB2plan(value)─┘ └─ACTIVITYId(value)─┘ └─Wait───┘ ──┬─────────────────┬──┬────────────────┬──┬────────────────────┬── └─ACTIVITY(value)─┘ └─PROCESS(value)─┘ └─PROCESSType(value)─┘

|

CEMT INQUIRE TCLASS
┌─ALl─────┐ ──CEMT Inquire TClass──┼─────────┼──┬──────────────────┬───────────────────── └─(value)─┘ └─Maxactive(value)─┘ ──┬───────────────┬──┬────────────────────┬──┬───────────────┬── └─ACtive(value)─┘ └─Purgethresh(value)─┘ └─Queued(value)─┘

CEMT INQUIRE TCPIPSERVICE
──INQUIRE TCPIPSERVICE(value)──┬────────────────┬──┬─────────────────────┬─── └─Backlog(value)─┘ └─CLOsetimeout(value)─┘ ──┬───────────────────┬──┬──────────────────┬──┬───────────────────┬────────── └─Connection(value)─┘ └─IPaddress(value)─┘ ├─OPENSTATUS(value)─┤ ├─OPEN──────────────┤ ├─CLOSING───────────┤ ├─CLOSED────────────┤ └─IMMCLOSING────────┘ ──┬─────────────┬──┬────────────────┬──┬────────────────────┬───────────────── └─Port(value)─┘ ├─SSLTYPE(value)─┤ ├─SOcketclose(value)─┤ ├─NO─────────────┤ ├─Wait───────────────┤ ├─YES────────────┤ └─TImeout────────────┘ └─CLIENTAUTH─────┘ ──┬─────────────────────┬──┬────────────────┬──┬──────────────────┬─────────── └─TCPIPService(value)─┘ └─TRansid(value)─┘ └─TSqprefix(value)─┘ ──┬────────────┬── └─URM(value)─┘

Chapter 3. CICS-Supplied Transaction

179

CST syntax

CEMT INQUIRE TDQUEUE
┌─All─────┐ ──CEMT Inquire TDqueue──┼─────────┼──┬─────────────────────┬──┬──────────┬─── └─(value)─┘ └─TRIggerlevel(value)─┘ ├─INDirect─┤ ├─EXtra────┤ ├─INTra────┤ └─REMote───┘ ──┬────────────────┬──┬──────────┬──┬────────┬──┬───────────────┬───────────── └─NAmeind(value)─┘ ├─ENabled──┤ ├─OPen───┤ └─TErmid(value)─┘ └─DIsabled─┘ └─Closed─┘ ──┬───────────────┬──┬───────────────┬──┬─────┬──┬────────┬──┬────────┬─────── └─TRAnid(value)─┘ └─Userid(value)─┘ ├─Shr─┤ ├─INPut──┤ ├─Queue──┤ ├─OLd─┤ ├─OUtput─┤ └─REJect─┘ └─Mod─┘ └─RDback─┘ ──┬────────┬──┬────────────────────┬──┬───────────────┬──┬───────────────┬── ├─Wait───┤ └─DAtabuffers(value)─┘ └─DDname(value)─┘ └─DSname(value)─┘ └─NOwait─┘

CEMT INQUIRE TERMINAL
┌─ALl──────────┐ ──CEMT Inquire TErminal──┼──────────────┼──┬────────────────────┬──────────── ├─(value)──────┤ └─TRansaction(value)─┘ └─CLass(value)─┘ | ──┬────────────────┬──┬─────────────────┬──┬──────────────┬─────────────────── └─COnsole(value)─┘ └─PRiority(value)─┘ ├─PAgeable─────┤ └─AUtopageable─┘ ──┬────────────┬──┬───────┬──┬───────┬──┬───────────┬──┬────────────────┬───── ├─Inservice──┤ ├─ATi───┤ ├─TTi───┤ ├─RTerminal─┤ └─NEtname(value)─┘ └─Outservice─┘ └─NOAti─┘ └─NOTti─┘ ├─RSession──┤ ├─Session───┤ └─Local─────┘ ──┬──────────┬──┬──────────┬──┬─────────────┬──┬─────────────────────┬──────── ├─ACquired─┤ ├─CReate───┤ └─TAsk(value)─┘ └─REMotesystem(value)─┘ └─RELeased─┘ └─NOCreate─┘ ──┬──────────────┬──┬─────────────────┬──┬───────────────┬──┬────────────┬── └─RNAme(value)─┘ └─RNEtname(value)─┘ └─Userid(value)─┘ └─CId(value)─┘

180

CICS User’s Handbook

CST syntax

CEMT INQUIRE TRANSACTION
┌─ALl──────────┐ ──CEMT Inquire TRAnsaction──┼──────────────┼──┬─────────────────┬──────────── ├─(value)──────┤ └─PRIority(value)─┘ └─CLass(value)─┘ ──┬────────────────┬──┬───────────────┬──┬──────────┬──┬──────────────┬─────── └─PROgram(value)─┘ └─TClass(value)─┘ ├─Enabled──┤ ├─PUrgeable────┤ └─Disabled─┘ └─NOTPurgeable─┘ ──┬───────────────┬──┬──────────┬──┬───────┬──┬───────────┬─────────────────── └─PRFile(value)─┘ ├─CDatakey─┤ ├─ANy───┤ ├─ISolate───┤ └─Udatakey─┘ └─BElow─┘ └─NOIsolate─┘ ──┬───────────────┬──┬─────────┬──┬───────────────┬─────────────────────────── └─TRprof(value)─┘ ├─BAckout─┤ └─BRexit(value)─┘ └─COmmit──┘ ──┬─────────────────────┬──┬────────────────────┬──┬────────┬───────────────── └─FAcilitylike(value)─┘ └─INdoubtmins(value)─┘ ├─NOWait─┤ └─Wait───┘ | | ──┬─────────────┬── ├─Routable────┤ └─NOTRoutable─┘

CEMT INQUIRE TRDUMPCODE
┌─ALl─────┐ ──CEMT Inquire TRDumpcode──┼─────────┼──┬────────────┬──┬───────────┬──────── └─(value)─┘ ├─Trandump───┤ ├─SYsdump───┤ └─NOTrandump─┘ └─NOSYsdump─┘ ──┬────────────┬──┬─────────┬──┬────────────────┬──┬────────────────┬── ├─SHutdown───┤ ├─RELated─┤ └─Maximum(value)─┘ └─Current(value)─┘ └─NOSHutdown─┘ └─Local───┘

| | | | | | | | | | |

CEMT INQUIRE TSMODEL
┌─ALl─────┐ ┌── ───────────────────────────┐ ──CEMT Inquire TSModel──┼─────────┼───┬─────────────────────────┬┴── └─(value)─┘ ├─LOCATION(value)─────────┤ ├─POOLNAME(data-area)─────┤ ├─PREFIX(data-area)───────┤ ├─RECOVSTATUS(value)──────┤ ├─REMOTEPREFIX(data-area)─┤ ├─REMOTESYSTEM(data-area)─┤ └─SECURITYST(value)───────┘

| | | | |

CEMT INQUIRE TSPOOL
┌─ALl─────┐ ──CEMT Inquire TSPool──┼─────────┼──┬──────────────────┬── └─(value)─┘ └─CONNSTATUS(cvda)─┘

Chapter 3. CICS-Supplied Transaction

181

CST syntax

CEMT INQUIRE TSQNAME
┌─ALl─────┐ ──CEMT Inquire TSqname──┼─────────┼──┬──────────────┬──┬─────────────────┬─── └─(value)─┘ └─Sysid(value)─┘ └─Numitems(value)─┘ ──┬────────────────────┬──┬───────────────┬──┬───────────┬──────────────────── └─LAstusedint(value)─┘ └─LEngth(value)─┘ ├─MAIn──────┤ └─AUxiliary─┘ ──┬───────────────────┬──┬───────────────────┬──┬────────────────┬── └─MAXitemlen(value)─┘ └─MInitemlen(value)─┘ └─Transid(value)─┘

CEMT INQUIRE TSQUEUE
| | | ┌─ALl─────┐ ──CEMT Inquire TSQueue──┼─────────┼──┬─────────────────┬───────────────────── └─(value)─┘ ├─SYSID(value)────┤ └─POOLNAME(value)─┘ ──┬─────────────────┬──┬────────────────────┬──┬───────────────┬────────────── └─Numitems(value)─┘ └─LAstusedint(value)─┘ └─LEngth(value)─┘ ──┬───────────┬──┬───────────────────┬──┬───────────────────┬───────────────── ├─MAIn──────┤ └─MAXitemlen(value)─┘ └─MInitemlen(value)─┘ └─AUxiliary─┘ | ──RECOVSTATUS(value)──┬────────────────┬── └─Transid(value)─┘

CEMT INQUIRE UOW
┌─ALl─────┐ ──CEMT Inquire UOW──┼─────────┼──┬──────────┬──┬─────────┬─────────────────── └─(value)─┘ ├─Backout──┤ ├─ACtive──┤ ├─COMmit───┤ ├─WAITIng─┤ ├─INDoubt──┤ └─SHunted─┘ ├─INFlight─┤ ├─HBackout─┤ └─HCommit──┘ ──┬────────────────┬──┬───────────────┬──┬────────────┬──┬───────────────┬──── └─TRansid(value)─┘ └─TAskid(value)─┘ └─AGe(value)─┘ └─TErmid(value)─┘ ──┬────────────────┬──┬───────────────┬──┬────────────┬──┬─────────────┬────── └─NETName(value)─┘ └─Userid(value)─┘ ├─CONnection─┤ └─Link(value)─┘ ├─Dataset────┤ ├─Rlsserver──┤ ├─WAITCommit─┤ ├─WAITForget─┤ └─WAITRmi────┘ ──┬──────────────┬──┬─────────────────┬── └─SYsid(value)─┘ └─NETUowid(value)─┘

182

CICS User’s Handbook

CST syntax

CEMT INQUIRE UOWDSNFAIL
──CEMT Inquire UOWDsnfail──UOw(value)──DSname(value)──┬────────┬───────────── ├─NOtrls─┤ └─RLS────┘ ──┬────────────┬──┬──────────────┬──┬──────────────┬──┬────────────────┬── ├─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
──CEMT Inquire UOWEnq──┬────────────┬──┬────────────────┬──────────────────── └─Uow(value)─┘ └─TRansid(value)─┘ ──┬───────────────┬──┬──────────┬──┬─────────────┬──┬────────┬──────────────── └─TAskid(value)─┘ ├─ACtive───┤ ├─Dataset─────┤ ├─Owner──┤ └─RETained─┘ ├─File────────┤ └─Waiter─┘ ├─EXecenq─────┤ ├─ADdrexecenq─┤ ├─TDq─────────┤ └─TSq─────────┘ ──┬─────────────────┬──┬─────────────────┬──┬─────────────────┬─────────────── └─Netuowid(value)─┘ └─ENqfails(value)─┘ └─RESource(value)─┘ ──┬─────────────┬──┬──────────────────┬──┬─────────────┬── └─RLen(value)─┘ └─QUalifier(value)─┘ └─QLen(value)─┘

CEMT INQUIRE UOWLINK
┌─ALl─────┐ ──CEMT Inquire UOWLink──┼─────────┼──┬────────────┬──┬────────────┬────────── └─(value)─┘ └─UOw(value)─┘ ├─CONnection─┤ └─RMI────────┘ ──┬─────────────┬──┬─────────────┬──┬───────────┬──┬─────────────┬──────────── └─LInk(value)─┘ ├─COOrdinator─┤ ├─Irc───────┤ ├─COLdstart───┤ ├─SUbordinate─┤ ├─APpc──────┤ ├─STarting────┤ └─UNKnown─────┘ ├─LU61──────┤ ├─Warmstart───┤ ├─NOtapplic─┤ ├─UNAvailable─┤ └─Rrms──────┘ ├─UNConnected─┤ └─NOtapplic───┘ ──┬──────────────┬──┬───────────────┬──┬─────────────────┬── └─SYsid(value)─┘ └─RMIQfy(value)─┘ └─NEtuowid(value)─┘

|

CEMT INQUIRE VTAM
──CEMT Inquire Vtam──

Chapter 3. CICS-Supplied Transaction

183

CST syntax

CEMT PERFORM DELETSHIPPED
──CEMT Perform DEletshipped──

CEMT PERFORM ENDAFFINITY
──CEMT Perform Endaffinity──NETName(value)──┬──────────────┬── └─NETId(value)─┘

CEMT PERFORM RESET
──CEMT Perform Reset──

CEMT PERFORM SECURITY REBUILD
──CEMT Perform SEcurity───┬─────────┬─── └─Rebuild─┘

CEMT PERFORM SHUTDOWN
──CEMT Perform SHUTdown──┬────────────┬──┬────────────┬──┬───────────────┬─── └─Xlt(value)─┘ └─Plt(value)─┘ ├─Sdtran(value)─┤ └─NOSdtran──────┘ ──┬──────────────────────────┬───┬──────────┬────┬──────┬─── └─Immediate──┬───────────┬─┘ └─Takeover─┘ └─Dump─┘ └─NORestart─┘

CEMT PERFORM DUMP
──CEMT Perform──┬─DUmp─┬──┬──────────────┬── └─SNap─┘ └─Title(value)─┘

184

CICS User’s Handbook

CST syntax

CEMT PERFORM STATISTICS
┌── ─────────────────────┐ ──CEMT Perform STatistics───┬────────┬────┬─ALl──┬──────────┬─┬┴── └─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
| ──CEMT Set AUToinstall──┬─────────────────┬──┬────────────────┬────────────── └─Consoles(value)─┘ └─Maxreqs(value)─┘ ──┬────────────────┬── └─Program(value)─┘

CEMT SET AUXTRACE
──CEMT Set AUXtrace──┬───────┬──┬──────────┬───┬────────┬─── ├─STArt─┤ ├─NOswitch─┤ └─SWitch─┘ ├─Pause─┤ ├─NExt─────┤ └─STOp──┘ └─All──────┘

CEMT SET CONNECTION
──CEMT Set Connection──┬─(value)─┬───┬────────────┬───┬────────────┬───────── └─ALl─────┘ └─NOTpending─┘ ├─INService──┤ └─OUtservice─┘ ──┬──────────┬──┬────────────┬──┬──────────┬──┬─────────────┬───────────────── ├─ACquired─┤ ├─PUrge──────┤ ├─COmmit───┤ └─ENdaffinity─┘ └─RELeased─┘ ├─FORCEPurge─┤ ├─Backout──┤ ├─CAncel─────┤ ├─FORCEUow─┤ └─FCancel────┘ └─RESync───┘ ──┬─────────────┬── └─NORecovdata─┘

Chapter 3. CICS-Supplied Transaction

185

CST syntax

CEMT SET DB2CONN
──CEMT Set DB2Conn─────────────────────────────────────────────────────────── ┌── ───────────────────────────┐ ┌── ───────────────────────────┐ ───┬─────────────────────────┬┴───┬─────────────────────────┬┴── ├─┬─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
┌── ───────────────────────────┐ ──CEMT Set DB2Entry──┬─────────────┬───┬─────────────────────────┬┴── └─(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
┌── ───────────────────────┐ ──CEMT Set DB2Tran───┬─────────────────────┬┴── ├─DB2Entry(data-area)─┤ └─Transid(data-area)──┘

CEMT SET DELETSHIPPED
──CEMT Set DEletshipped──┬─────────────────┬──┬─────────────┬── └─INterval(value)─┘ └─IDle(value)─┘

CEMT SET DSAS
──CEMT Set DSAs──┬─────────────────┬──┬──────────────────┬── └─Dsalimit(value)─┘ └─EDsalimit(value)─┘

Chapter 3. CICS-Supplied Transaction

187

CST syntax

CEMT SET DSNAME
──CEMT Set DSName──┬─(value)─┬──┬────────────┬──┬─────────────┬────────────── └─ALl─────┘ ├─REMOve─────┤ ├─AVailable───┤ ├─RECOVEREd──┤ └─UNAvailable─┘ ├─RESetlocks─┤ └─RETRy──────┘ ──┬─────────────┬──┬─────────┬── ├─Quiesced────┤ ├─BACkout─┤ ├─UNQuiesced──┤ ├─Commit──┤ └─IMmquiesced─┘ └─FOrce───┘

CEMT SET DUMPDS
──CEMT Set DUmpds──┬────────┬──┬──────────────┬── ├─Open───┤ ├─Autoswitch───┤ ├─CLosed─┤ └─Noautoswitch─┘ └─Switch─┘

| | | | |

CEMT SET ENQMODEL
──CEMT Set ENQModel(value)──┬──────────┬── ├─Enabled──┤ └─DIsabled─┘

CEMT SET FILE
──CEMT Set FIle──┬─(value)─┬──┬────────────┬──┬──────────┬──┬────────┬─────── └─ALl─────┘ ├─OPen───────┤ ├─ENabled──┤ ├─REAd───┤ ├─CLosed─────┤ └─DIsabled─┘ └─NORead─┘ └─Forceclose─┘ ──┬──────────┬──┬───────────┬──┬──────────┬──┬──────────┬──┬─────────────┬──── ├─UPdate───┤ ├─ADdable───┤ ├─BRowse───┤ ├─DElete───┤ ├─EXclusive───┤ └─NOUpdate─┘ └─NOAddable─┘ └─NOBrowse─┘ └─NODelete─┘ └─NOEXclusive─┘ ──┬────────────┬──┬───────┬──┬────────┬──┬───────────────┬──┬───────────┬───── ├─EMptyreq───┤ ├─Old───┤ ├─RLs────┤ └─DSname(value)─┘ ├─NOTTable──┤ └─NOEMptyreq─┘ └─Share─┘ └─NOTRls─┘ ├─CIcstable─┤ ├─USertable─┤ └─CFTable───┘ ──┬────────┬──┬─────────────────┬──┬──────────────────┬──┬────────────┬─────── ├─LOAd───┤ └─CFDtpool(value)─┘ └─Tablename(value)─┘ ├─COntention─┤ └─NOLoad─┘ └─LOCking────┘ ──┬───────────────────┬──┬──────────────────┬──┬───────────────────┬── └─Maxnumrecs(value)─┘ └─Keylength(value)─┘ └─RECordsize(value)─┘

| | | |

CEMT SET GTFTRACE
──CEMT Set Gtftrace──┬───────┬── ├─STArt─┤ └─STOp──┘

CEMT SET INTTRACE
──CEMT Set INttrace──┬───────┬── ├─STArt─┤ └─STOp──┘

188

CICS User’s Handbook

CST syntax

CEMT SET IRC
──CEMT SET IRc──┬─Open─────┬── ├─Closed───┤ └─Immclose─┘

CEMT SET JOURNALNAME
──CEMT Set Journalname(value)──┬─(value)─┬──┬──────────┬──┬───────┬── └─All─────┘ ├─Enabled──┤ ├─FLush─┤ └─DIsabled─┘ └─Reset─┘

CEMT SET LINE
──CEMT Set Line(value)──┬───────────────┬──┬────────────────┬──────────────── └─NUmber(value)─┘ └─NEgpoll(value)─┘ ──┬────────────┬──┬────────────┬── ├─Inservice──┤ ├─Purge──────┤ └─Outservice─┘ └─Forcepurge─┘

CEMT SET MODENAME
──CEMT Set MODename──┬─(value)─┬──┬───────────────────┬────────────────────── └─ALl─────┘ └─COnnection(value)─┘ ──┬──────────────────┬──┬──────────┬── └─AVailable(value)─┘ ├─ACQuired─┤ └─CLosed───┘

CEMT SET MONITOR
──CEMT Set MONitor──┬─────┬──┬────────┬──┬─────────┬──┬──────────┬─────────── ├─ON──┤ ├─Perf───┤ ├─EVent───┤ ├─EXcept───┤ └─OFf─┘ └─NOPerf─┘ └─NOEVent─┘ └─NOEXcept─┘ ──┬────────────┬──┬─────────────┬──┬──────────────────┬── ├─Converse───┤ ├─SYncpoint───┤ └─Frequency(value)─┘ └─NOConverse─┘ └─NOSyncpoint─┘

CEMT SET NETNAME
──CEMT Set Netname──┬─(value)─┬──┬─────────────────┬──┬──────────────┬─────── └─ALl─────┘ └─PRiority(value)─┘ ├─PAgeable─────┤ └─AUtopageable─┘ ──┬────────────┬──┬───────┬──┬───────┬──┬────────────┬──┬──────────┬────────── ├─Inservice──┤ ├─ATi───┤ ├─TTi───┤ ├─PUrge──────┤ ├─ACquired─┤ └─Outservice─┘ └─NOAti─┘ └─NOTti─┘ └─Forcepurge─┘ ├─COldacq──┤ └─RELeased─┘ ──┬──────────┬── ├─CReate───┤ └─NOCreate─┘

Chapter 3. CICS-Supplied Transaction

189

CST syntax

CEMT SET PROCESSTYPE
┌─ALl─────┐ ──CEMT Set PROCesstype──┼─────────┼──┬──────────┬──┬──────────┬── └─(value)─┘ ├─ACtivity─┤ ├─Enabled──┤ ├─FUll─────┤ └─Disabled─┘ ├─Off──────┤ └─Process──┘

CEMT SET PROGRAM
┌─PRIvate─┐ ──CEMT Set Program──┬─(value)──────┬──┬──────────┬──┼─────────┼────────────── ├─CLass(value)─┤ ├─Enabled──┤ └─Shared──┘ └─ALl──────────┘ └─DIsabled─┘ | | | | ──┬─────────┬──┬────────┬──┬───────────┬──┬─────────────────┬──┬─────────┬──── ├─NEwcopy─┤ ├─CEDf───┤ ├─DPlsubset─┤ └─JVMClass(value)─┘ ├─DEBUG───┤ └─PHasein─┘ └─NOCedf─┘ └─Fullapi───┘ └─NODEBUG─┘ ──┬───────┬── ├─JVM───┤ └─NOJVM─┘

CEMT SET STATISTICS
──CEMT Set STatistics──┬─────┬───┬──────────┬────┬───────────┬─────────────── ├─ON──┤ └─RESetnow─┘ └─RECordnow─┘ └─OFf─┘ ──┬──────────────────┬──┬──────────────────┬── └─Interval(hhmmss)─┘ └─Endofday(hhmmss)─┘

CEMT SET SYDUMPCODE
──CEMT Set SYDumpcode──┬─(value)─┬──┬───────────┬──┬────────────┬──────────── └─ALl─────┘ ├─SYsdump───┤ ├─SHutdown───┤ └─NOSYsdump─┘ └─NOSHutdown─┘ ──┬─────────┬──┬────────────────┬──┬────────┬──┬───────┬── ├─RELated─┤ └─Maximum(value)─┘ ├─RESet──┤ ├─Dae───┤ └─Local───┘ ├─REMove─┤ └─NODae─┘ └─ADd────┘

190

CICS User’s Handbook

CST syntax

CEMT SET SYSTEM
┌── ────────────────────────┐ ──CEMT Set SYStem───┬──────────────────────┬┴── ├─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
──CEMT Set TAsk──┬─(value)─┬──┬─────────────────┬──┬────────────┬── └─All─────┘ └─PRiority(value)─┘ ├─PUrge──────┤ └─FOrcepurge─┘

CEMT SET TCLASS
──CEMT Set TClass──┬─(value)─┬──┬──────────────────┬───────────────────────── └─ALl─────┘ └─Maxactive(value)─┘ ──┬────────────────────┬── └─Purgethresh(value)─┘

CEMT SET TCPIP
──CEMT Set TCPIP──┬─(value)─┬──┬─Openstatus(cvda)─┬── └─ALl─────┘ ├─OPEN─────────────┤ ├─CLOSE────────────┤ └─IMMCLOSE─────────┘

CEMT SET TCPIPSERVICE
──CEMT Set TCPIPSERVICE──┬─(value)─┬──┬────────────────┬───────────────────── └─ALl─────┘ └─Backlog(value)─┘ ──┬──────────────────┬──┬────────────┬── ├─Openstatus(cvda)─┤ └─URM(value)─┘ ├─OPEN─────────────┤ ├─CLOSE────────────┤ └─IMMCLOSE─────────┘

Chapter 3. CICS-Supplied Transaction

191

CST syntax

CEMT SET TDQUEUE
──CEMT Set TDqueue──┬─(value)─┬──┬─────────────────────┬──┬──────────┬─────── └─All─────┘ └─TRIggerlevel(value)─┘ ├─ENabled──┤ └─DIsabled─┘ ──┬────────┬── ├─OPen───┤ └─Closed─┘

CEMT SET TERMINAL
──CEMT Set TErminal──┬─(value)──────┬──┬─────────────────┬─────────────────── ├─CLass(value)─┤ └─PRiority(value)─┘ └─ALl──────────┘ ──┬──────────────┬──┬────────────┬──┬───────┬──┬───────┬──┬────────────┬────── ├─PAgeable─────┤ ├─Inservice──┤ ├─ATi───┤ ├─TTi───┤ ├─PUrge──────┤ └─AUtopageable─┘ └─Outservice─┘ └─NOAti─┘ └─NOTti─┘ ├─Forcepurge─┤ └─CAncel─────┘ ──┬──────────┬──┬──────────┬── ├─ACquired─┤ ├─CReate───┤ ├─COldacq──┤ └─NOCreate─┘ └─RELeased─┘

CEMT SET TRANSACTION
──CEMT Set TRAnsaction──┬─(value)──────┬──┬─────────────────┬──────────────── ├─CLass(value)─┤ └─PRIority(value)─┘ └─ALl──────────┘ ──┬───────────────┬──┬──────────┬──┬──────────────┬── └─TClass(value)─┘ ├─Enabled──┤ ├─PUrgeable────┤ └─Disabled─┘ └─NOTpurgeable─┘

CEMT SET TRDUMPCODE
──CEMT Set TRDumpcode──┬─(value)─┬──┬────────────┬──┬───────────┬──────────── └─ALl─────┘ ├─Trandump───┤ ├─SYsdump───┤ └─NOTrandump─┘ └─NOSYsdump─┘ ──┬────────────┬──┬─────────┬──┬────────────────┬──┬────────┬── ├─SHutdown───┤ ├─RELated─┤ └─Maximum(value)─┘ ├─RESet──┤ └─NOSHutdown─┘ └─Local───┘ ├─REMove─┤ └─ADd────┘

| | | | | | | |

CEMT SET TSQUEUE
┌─ALl─────┐ ──CEMT Set TSqueue──┼─────────┼──┬─────────────────┬───────────────────────── └─(value)─┘ ├─SYSID(value)────┤ └─POOLNAME(value)─┘ ──┬────────────────────┬──┬─Action(value)─┬── └─LAstusedint(value)─┘ └─DELETE────────┘

192

CICS User’s Handbook

CST syntax

CEMT SET UOW
──CEMT Set UOW(value)──┬─(value)─┬──┬─COMmit──┬── └─ALl─────┘ ├─Backout─┤ └─Force───┘

CEMT SET UOWLINK
──CEMT Set UOWlink(value)──┬─(value)─┬──Delete── └─ALl─────┘

CEMT SET VTAM
──CEMT Set Vtam──┬─Open───────┬──┬─────────────────────┬──┬──────────────┬── ├─Closed─────┤ └─Psdinterval(hhmmss)─┘ └─Deregistered─┘ ├─Immclose───┤ └─Forceclose─┘

CEOT
──CEOT──┬──────────────┬──┬───────┬──┬───────┬── ├─PAgeable─────┤ ├─ATi───┤ ├─TTi───┤ └─AUtopageable─┘ └─NOAti─┘ └─NOTti─┘

CESF
──CESF──┬───────────┬── ├─GOODNIGHT─┤ └─LOGOFF────┘

CESN
| ──CESN USERID=uuuuuuuu──CESN──USERID=uuuuuuuu──┬───────────────────┬──────── └─,GROUPID=gggggggg─┘

──┬───────────────┬──┬──────────────┬──┬─────────────────┬── └─,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
──CMSG──┬──────┬──'message'────────────────────────────────────────────────── └─MSG=─┘ ┌── ──────────────┐ ──┬─────────────────────────────────────────────────┬───┬────────────┬┴─────── │ ┌── ───────────────┐ │ └─,OPCLASS=n─┘ └─,ROUTE=──┬───Termid──/opid─┴──────────────────┬─┘ ├─ALL────────────────────────────────┤ │ ┌── ───────────┐ ┌── ─────────────────┐ │ └───.termlist─┴────,±termid──/opid─┴─┘ ──┬─────────────┬──┬─────────────────┬──┬───────────────────────┬───────────── └─,TIME=value─┘ ├─,DATE=value─────┤ └─,ERRTERM=─┬─Termid─┬──┘ └─,FULLDATE=value─┘ └─ORIG───┘ ──┬─────────────┬──┬────────────────────┬──┬───────────────────────┬────────── └─,ID=(title)─┘ └─,HEADING=─┬─YES─┬──┘ └─,PROTECT=─┬─YES────┬──┘ └─NO──┘ ├─NO─────┤ └─Prefix─┘ ──┬─,SEND───┬── └─,CANCEL─┘

ROUTE
┌── ─────────────────────┐ ──ROUTE=──┬───Termid── ldc──/opid─┴─────────┬── ├─ALL── ldc───────────────────────┤ │ ┌── ─────────────────┐ │ └───.termlist── ldc─┴──┤ Idloop ├─┘ Idloop: ┌── ─────────────────────────┐ ├───┬───────────────────────┬┴──┤ └─,±termid── ldc──/opid─┘

CRTE
──CRTE──SYSID=sysid──┬────────────────┬── └─,TRPROF=trprof─┘

CSFE SPOOLFE
──CSFE spoolfe=──┬─ON──┬── └─OFF─┘

CSFE ZCQTRACE
──CSFE zcqtrace──┬─=termid──────┬── ├─,AUTOINSTALL─┤ └─,OFF─────────┘

CSFE DEBUG TRANID
──CSFE debug──┬─,TRANID=xxxx─┬──┬───────────────────┬── └─,TASKREQ=yyy─┘ │ ┌─OFF─┐ │ └─,STGFRZ=─┴─ON──┴──┘

194

CICS User’s Handbook

CST syntax

CSFE DEBUG CHKSTSK
──CSFE debug──┬─,CHKSTSK=─┬─CURRENT─┬──┬── │ └─NONE────┘ │ └─,CHKSTRM=─┬─CURRENT─┬──┘ └─NONE────┘

CSPG GETPAGE
──CSPG──Getpage──┬───┬──B──┬──────┬──┬─────────┬── └─A─┘ ├─ ldc─┤ └─,hhhhhh─┘ └─ ALL─┘

CSPG MESSCHNYYYY
──CSPG──Messchnyyyy──┬────────────┬── └─Parameters─┘

CSPG MSGTERM
──CSPG──Msgterm──┬─A─┬──┬─────────┬── ├─B─┤ └─,hhhhhh─┘ ├─C─┤ ├─H─┤ └─R─┘

CWTO
──CWTO──Message──

Chapter 3. CICS-Supplied Transaction

195

CST syntax

196

CICS User’s Handbook

RDO

Chapter 4. Resource definition online
The syntax diagrams that follow are taken from the CICS Resource Definition Guide.

ADD syntax
──ADd──Group(groupname1)──LIst(listname)──┬────────────────────┬── ├─Before(groupname2)─┤ └─After(groupname3)──┘

ALTER syntax
──ALter──┬─Connection(name)───┬──Group(groupname)──────────────────────── ├─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)─────┘ ──attribute list(new value)──

| |

| | |

|

APPEND syntax
──APpend──LIst(listname1)──To(listname2)──

© Copyright IBM Corp. 1989, 1999

197

RDO

CHECK syntax
──CHeck──┬─Group(groupname)─────────────────────────────────┬──────────── └─List(listname1, listname2, listname3, listname4)─┘ | ──┬─────────────────────┬── └─Remotesystem(sysid)─┘

COPY syntax
┌─All────────────────┐ ──COpy──┼────────────────────┼──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)─────┘ ──┬─AS(newname)───────────────────┬──┬─────────┬── ├─TO(newgroupname)──────────────┤ ├─Replace─┤ └─AS(new-name) TO(newgroupname)─┘ └─MErge───┘

| |

| | |

|

198

CICS User’s Handbook

RDO

USERDEFINE syntax
──USerdefine──┬─Connection(name)───┬──Group(groupname)─────────────────── ├─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)─────┘ ──attribute list(newvalue)──

DEFINE syntax
──DEFine──┬─Connection(name)───┬──Group(groupname)─────────────────────── ├─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)─────┘ ──attribute list(newvalue)──

| |

| | |

|

Chapter 4. Resource definition online

199

RDO

DELETE syntax
| ──DELete──┬─All────────────────┬──Group(groupname)─┬────────┬─── ├─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
──DISplay──┬─List(listname)──┬──────────────────┬─────────────────┬── │ └─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
──EXPand──┬─List(listname)──┬──────────────────┬─────────────────┬── │ └─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
| | ──Install──┬────────────────────┬──┬─Group(groupname)─┬── ├─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
──Lock──┬─Group(groupname)─┬── └─List(listname)───┘

MOVE syntax
| ┌─All────────────────┐ ──Move──┼────────────────────┼──Group(groupname)─┬────────┬────────────── ├─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)─────┘ ──┬─AS(newname)──────────────────┬──┬─────────┬── ├─TO(newgroupname)─────────────┤ ├─REPlace─┤ └─AS(newname) TO(newgroupname)─┘ └─MErge───┘

| |

| | |

|

|

REMOVE syntax
──REMove──Group(groupname)──List(listname)──

202

CICS User’s Handbook

RDO

RENAME syntax
──REName──┬────────────────────┬──┬──────────────────┬─────────────────── ├─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)─────┘ ──┬─────────────┬──┬──────────────────┬──┬────────┬── └─AS(newname)─┘ └─TO(newgroupname)─┘ └─REMove─┘

| |

| | |

|

|

UNLOCK syntax
──UNLock──┬─Group(groupname)─┬── └─List(listname)───┘

Chapter 4. Resource definition online

203

RDO

USERDEFINE syntax
──USerdefine──┬─Connection(name)───┬──Group(groupname)─────────────────── ├─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)─────┘ ──attribute list(newvalue)──

| |

| | |

|

VIEW syntax
──View──Group(groupname)──┬────────────────────┬── ├─ALl(name)──────────┤ ├─Connection(name)───┤ ├─DB2Conn(name)──────┤ ├─DB2Entry(name)─────┤ ├─DB2Tran(name)──────┤ ├─DOctemplate(name)──┤ ├─Enqmodel(name)─────┤ ├─File(name)─────────┤ ├─Journalmodel(name)─┤ ├─Lsrpool(name)──────┤ ├─Mapset(name)───────┤ ├─PARTItionset(name)─┤ ├─PARTNer(name)──────┤ ├─PROFile(name)──────┤ ├─PROCesstype(name)──┤ ├─PROGram(name)──────┤ ├─Requestmodel(name)─┤ ├─Sessions(name)─────┤ ├─TCpipservice(name)─┤ ├─TDqueue(name)──────┤ ├─TErminal(name)─────┤ ├─TRANClass(name)────┤ ├─TRANSaction(name)──┤ ├─TSmodel(name)──────┤ └─TYpeterm(name)─────┘

| |

| | |

|

204

CICS User’s Handbook

CSD

Chapter 5. DFHCSDUP commands
The syntax diagrams that follow are taken from the CICS Resource Definition Guide.

ADD syntax
──ADd──Group(groupname)──LIst(listname)──

ALTER syntax
──ALter──┬─Connection(name)───┬──Group(groupname)──────────────────────── ├─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)─────┘ ──attribute list(new value)──

| |

| | |

|

APPEND syntax
──APpend──FRomcsd(ddname)──LIst(listname1)──To(listname2)──

© Copyright IBM Corp. 1989, 1999

205

CSD

COPY syntax
──Copy──Group(groupname1)──To(groupname2)──┬─────────┬─────────────────── ├─Replace─┤ └─MErge───┘ ──FRomcsd(ddname)──

DEFINE syntax
──DEFine──┬─Connection(name)───┬──Group(groupname)─────────────────────── ├─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)─────┘ ──attribute list(newvalue)──

| |

| | |

|

206

CICS User’s Handbook

CSD

DELETE syntax
| ──DELete──┬─List(listname)───────────────────────────────────────┬── └─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
──EXtract──┬─Group(groupname)─┬──┬─USerprogram(DFHxCRFy)─────────────┬─── └─LIst(listname)───┘ ├─USerprogram(DFHxFORy)─────────────┤ ├─USerprogram(DFH CBDC)─────────────┤ └─USerprogram(user-written program)─┘ ───┬─────────┬─── └─Objects─┘

INITIALIZE syntax
──INITialize──

Chapter 5. DFHCSDUP commands

207

CSD

LIST syntax
┌─All─┐ ──LIst──┬──┴─────┴─────────┬───┬─────────┬─── ├─Group(groupname)─┤ └─Objects─┘ └─LIst(listname)───┘

MIGRATE syntax
──MIgrate──TAble(tablename)──┬────────────────────────────┬────────────── └─TYpesgroup(typesgroupname)─┘ ──┬────────────────────┬── └─TOGROUP(groupname)─┘

REMOVE syntax
──Remove──Group(groupname)──LIst(listname)──

208

CICS User’s Handbook

CSD

SCAN syntax
──SCAN──┬─Connection(name)───┬──┬──────────────────┬── ├─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
──Service──FRomcsd(ddname)──LEvel(nnn)──

UPGRADE syntax
──UPgrade──┬─────────────────┬───┬─────────┬─── └─USing(filename)─┘ └─Replace─┘

VERIFY syntax
──VERIFY──

Chapter 5. DFHCSDUP commands

209

CSD

210

CICS User’s Handbook

FEPI programming

Chapter 6. Front End Programming Interface command reference
This chapter contains General Use Programming Interface information.

FEPI application programming
FEPI ALLOCATE PASSCONVID
──FEPI ALLOCATE──PASSCONVID(data-value)──

Conditions: INVREQ

FEPI ALLOCATE POOL
──FEPI ALLOCATE──POOL(data-value)──CONVID(data-area)───────────────────────── ──┬────────────────────┬──┬─────────────────────┬──┬─────────────────────┬──── └─TARGET(data-value)─┘ └─TIMEOUT(data-value)─┘ └─SEQNUMIN(data-area)─┘ ──┬──────────────────────┬──┬───────────────────┬── └─SEQNUMOUT(data-area)─┘ └─SESSNSTATUS(cvda)─┘

Conditions: INVREQ

FEPI AP NOOP
──FEPI AP NOOP──

Conditions: INVREQ

Previously allocated conversation

© Copyright IBM Corp. 1989, 1999

211

FEPI programming

FEPI CONVERSE DATASTREAM
──FEPI CONVERSE DATASTREAM──CONVID(data-value)──FROM(data-value)───────────── ┌─CHAIN─────┐ ──┬─────────────────────────┬──┼───────────┼──┬─────────────────┬──┬─────┬──── └─FROMFLENGTH(data-value)─┘ ├─RU────────┤ └─ENDSTATUS(cvda)─┘ └─FMH─┘ └─UNTILCDEB─┘ ──┬─────────────────┬──┬─────────────────────────────────────┬──────────────── └─FMHSTATUS(cvda)─┘ └──INTO(data-area)──┤ INTO options ├──┘ ──┬───────────────────────┬──┬──────────────────┬──┬─────────────────────┬──── └─REMFLENGTH(data-area)─┘ └─RESPSTATUS(cvda)─┘ └─SEQNUMIN(data-area)─┘ ──┬──────────────────────┬──┬─────────────────────┬── └─SEQNUMOUT(data-area)─┘ └─TIMEOUT(data-value)─┘ INTO options: ├──┬────────────────────────┬──┬──────────────────────┬──┤ └─MAXFLENGTH(data-value)─┘ └─TOFLENGTH(data-area)─┘

Conditions: INVREQ

212

CICS User’s Handbook

FEPI programming

Temporary conversation
FEPI CONVERSE DATASTREAM
──FEPI CONVERSE DATASTREAM──POOL(data-value)──┬────────────────────┬───────── └─TARGET(data-value)─┘ ┌─UNTILCDEB─┐ ──FROM(data-value)──┬─────────────────────────┬──┴───────────┴──────────────── └─FROMFLENGTH(data-value)─┘ ──┬─────────────────┬──┬─────┬──┬─────────────────┬─────────────────────────── └─ENDSTATUS(cvda)─┘ └─FMH─┘ └─FMHSTATUS(cvda)─┘ ──┬─────────────────────────────────────┬──┬───────────────────────┬────────── └──INTO(data-area)──┤ INTO options ├──┘ └─REMFLENGTH(data-area)─┘ ──┬──────────────────┬──┬─────────────────────┬──┬──────────────────────┬───── └─RESPSTATUS(cvda)─┘ └─SEQNUMIN(data-area)─┘ └─SEQNUMOUT(data-area)─┘ ──┬─────────────────────┬── └─TIMEOUT(data-value)─┘ INTO options: ├──┬────────────────────────┬──┬──────────────────────┬──┤ └─MAXFLENGTH(data-value)─┘ └─TOFLENGTH(data-area)─┘

Conditions: INVREQ

Previously allocated conversation
FEPI CONVERSE FORMATTED
──FEPI CONVERSE FORMATTED──CONVID(data-value)──FROM(data-value)────────────── ──┬─────────────────────────┬───────────────────────────────────────────────── └─FROMFLENGTH(data-value)─┘ ──┬─AID(data-value)──┬────────────────────────┬─┬───────────────────────────── │ └─FROMCURSOR(data-value)─┘ │ └─KEYSTROKES──┬────────────────────┬──────────┘ └─ESCAPE(data-value)─┘ ──┬─────────────────────────────────────┬──┬───────────────────┬────────────── └──INTO(data-area)──┤ INTO options ├──┘ └─ALARMSTATUS(cvda)─┘ ──┬────────────────────┬──┬─────────────────┬──┬───────────────────┬────────── └─COLUMNS(data-area)─┘ └─ENDSTATUS(cvda)─┘ └─FIELDS(data-area)─┘ ──┬──────────────────┬──┬──────────────────┬──┬─────────────────────┬───────── └─LINES(data-area)─┘ └─RESPSTATUS(cvda)─┘ └─TIMEOUT(data-value)─┘ ──┬─────────────────────┬── └─TOCURSOR(data-area)─┘ INTO options: ├──┬────────────────────────┬──┬──────────────────────┬──┤ └─MAXFLENGTH(data-value)─┘ └─TOFLENGTH(data-area)─┘

Conditions: INVREQ

Chapter 6. FEPI command reference

213

FEPI programming

Temporary conversation
FEPI CONVERSE FORMATTED
──FEPI CONVERSE FORMATTED──POOL(data-value)──┬────────────────────┬────────── └─TARGET(data-value)─┘ ──FROM(data-value)──┬─────────────────────────┬──KEYSTROKES─────────────────── └─FROMFLENGTH(data-value)─┘ ──┬────────────────────┬──┬─────────────────────────────────────┬───────────── └─ESCAPE(data-value)─┘ └──INTO(data-area)──┤ INTO options ├──┘ ──┬───────────────────┬──┬────────────────────┬──┬─────────────────┬────────── └─ALARMSTATUS(cvda)─┘ └─COLUMNS(data-area)─┘ └─ENDSTATUS(cvda)─┘ ──┬───────────────────┬──┬──────────────────┬──┬──────────────────┬─────────── └─FIELDS(data-area)─┘ └─LINES(data-area)─┘ └─RESPSTATUS(cvda)─┘ ──┬─────────────────────┬──┬─────────────────────┬── └─TIMEOUT(data-value)─┘ └─TOCURSOR(data-area)─┘ INTO options: ├──┬────────────────────────┬──┬──────────────────────┬──┤ └─MAXFLENGTH(data-value)─┘ └─TOFLENGTH(data-area)─┘

Conditions: INVREQ

FEPI EXTRACT CONV
──FEPI EXTRACT CONV──CONVID(data-value)──┬──────────────┬──────────────────── └─DEVICE(cvda)─┘ ──┬──────────────┬──┬─────────────────┬──┬───────────────────┬──────────────── └─FORMAT(cvda)─┘ └─POOL(data-area)─┘ └─TARGET(data-area)─┘ ──┬─────────────────┬──┬──────────────────────┬── └─NODE(data-area)─┘ └─SENSEDATA(data-area)─┘

Conditions: INVREQ

214

CICS User’s Handbook

FEPI programming

FEPI EXTRACT FIELD
──FEPI EXTRACT FIELD──CONVID(data-value)──┬─FIELDLOC(data-value)─┬─────────── └─FIELDNUM(data-value)─┘ ──┬─────────────────────────────────────┬──┬───────────────────────┬────────── └──INTO(data-area)──┤ INTO options ├──┘ └─BACKGROUND(data-area)─┘ ──┬──────────────────┬──┬──────────────────────┬──┬────────────────────┬────── └─COLOR(data-area)─┘ └─FIELDATTR(data-area)─┘ └─HILIGHT(data-area)─┘ ──┬─────────────────────────┬──┬───────────┬──┬────────────────────┬────────── └─INPUTCONTROL(data-area)─┘ └─MDT(cvda)─┘ └─OUTLINE(data-area)─┘ ──┬─────────────────────┬──┬───────────────┬──┬───────────────┬─────────────── └─POSITION(data-area)─┘ └─PROTECT(cvda)─┘ └─PS(data-area)─┘ ──┬─────────────────┬──┬─────────────────────────┬──────────────────────────── └─SIZE(data-area)─┘ └─TRANSPARENCY(data-area)─┘ ──┬───────────────────────┬── └─VALIDATION(data-area)─┘ INTO options: ├──┬────────────────────────┬──┬────────────────────┬──┤ └─MAXFLENGTH(data-value)─┘ └─FLENGTH(data-area)─┘

Conditions: INVREQ

FEPI EXTRACT STSN
──FEPI EXTRACT STSN──CONVID(data-value)──┬─────────────────────┬───────────── └─SEQNUMIN(data-area)─┘ ──┬──────────────────────┬──┬──────────────────┬── └─SEQNUMOUT(data-area)─┘ └─STSNSTATUS(cvda)─┘

Conditions: INVREQ

FEPI FREE
┌─HOLD────┐ ──FEPI FREE──CONVID(data-value)──┼─────────┼── ├─RELEASE─┤ ├─FORCE───┤ └─PASS────┘

Conditions: INVREQ

FEPI ISSUE
──FEPI ISSUE──CONVID(data-value)──CONTROL(cvda)──┬───────────────────────┬─── └─SENSEDATA(data-value)─┘ ──┬─────────────┬── └─VALUE(cvda)─┘

Conditions: INVREQ

Chapter 6. FEPI command reference

215

FEPI programming

FEPI RECEIVE DATASTREAM
┌─CHAIN─────┐ ──FEPI RECEIVE DATASTREAM──CONVID(data-value)──┼───────────┼───────────────── ├─RU────────┤ └─UNTILCDEB─┘ ──┬─────────────────┬──┬─────────────────┬──────────────────────────────────── └─ENDSTATUS(cvda)─┘ └─FMHSTATUS(cvda)─┘ ──┬─────────────────────────────────────┬──┬───────────────────────┬────────── └──INTO(data-area)──┤ INTO options ├──┘ └─REMFLENGTH(data-area)─┘ ──┬──────────────────┬──┬─────────────────────┬──┬──────────────────────┬───── └─RESPSTATUS(cvda)─┘ └─SEQNUMIN(data-area)─┘ └─SEQNUMOUT(data-area)─┘ ──┬─────────────────────┬── └─TIMEOUT(data-value)─┘ INTO options: ├──┬────────────────────────┬──┬────────────────────┬──┤ └─MAXFLENGTH(data-value)─┘ └─FLENGTH(data-area)─┘

Conditions: INVREQ

FEPI RECEIVE FORMATTED
──FEPI RECEIVE FORMATTED──CONVID(data-value)───────────────────────────────── ──┬─────────────────────────────────────┬──┬───────────────────┬────────────── └──INTO(data-area)──┤ INTO options ├──┘ └─ALARMSTATUS(cvda)─┘ ──┬────────────────────┬──┬───────────────────┬──┬─────────────────┬────────── └─COLUMNS(data-area)─┘ └─CURSOR(data-area)─┘ └─ENDSTATUS(cvda)─┘ ──┬───────────────────┬──┬──────────────────┬──┬──────────────────┬─────────── └─FIELDS(data-area)─┘ └─LINES(data-area)─┘ └─RESPSTATUS(cvda)─┘ ──┬─────────────────────┬── └─TIMEOUT(data-value)─┘ INTO options: ├──┬────────────────────────┬──┬────────────────────┬──┤ └─MAXFLENGTH(data-value)─┘ └─FLENGTH(data-area)─┘

Conditions: INVREQ

FEPI REQUEST PASSTICKET
──FEPI REQUEST PASSTICKET(data-area)──CONVID(data-value)───────────────────── ──┬────────────────────┬──┬──────────────────────┬── └─ESMRESP(data-area)─┘ └─ESMREASON(data-area)─┘

Conditions: INVREQ

216

CICS User’s Handbook

FEPI programming

FEPI SEND DATASTREAM
──FEPI SEND DATASTREAM──CONVID(data-value)──FROM(data-value)───────────────── ──┬─────────────────────┬──┬────────┬──┬─────┬──┬─────────────────────┬─────── └─FLENGTH(data-value)─┘ └─INVITE─┘ └─FMH─┘ └─SEQNUMIN(data-area)─┘ ──┬──────────────────────┬── └─SEQNUMOUT(data-area)─┘

Conditions: INVREQ

FEPI SEND FORMATTED
──FEPI SEND FORMATTED──CONVID(data-value)──FROM(data-value)────────────────── ──┬─────────────────────┬──┬─AID(data-value)──┬────────────────────┬─┬── └─FLENGTH(data-value)─┘ │ └─CURSOR(data-value)─┘ │ └─KEYSTROKES──┬────────────────────┬──────┘ └─ESCAPE(data-value)─┘

Conditions: INVREQ

FEPI START
──FEPI START──CONVID(data-value)──TRANSID(data-value)──────────────────────── ──┬────────────────────┬────────────────────────────────────────────────────── └─TERMID(data-value)─┘ ──┬─────────────────────────────────────────────────┬───────────────────────── └──USERDATA(data-value)──┬─────────────────────┬──┘ └─FLENGTH(data-value)─┘ ──┬─────────────────────┬── └─TIMEOUT(data-value)─┘

Conditions: INVREQ

Chapter 6. FEPI command reference

217

FEPI programming

FEPI system programming

FEPI ADD POOL
┌─ACQUIRED────────┐ ──FEPI ADD──POOL(data-value)──┼─────────────────┼──────────────────────────── ├─ACQSTATUS(cvda)─┤ └─RELEASED────────┘ ┌─INSERVICE────────┐ ──┬──────────────────────────────────────────┬──┼──────────────────┼────────── └─NODELIST(data-area)──NODENUM(data-value)─┘ ├─SERVSTATUS(cvda)─┤ └─OUTSERVICE───────┘ ──┬──────────────────────────────────────────────┬── └─TARGETLIST(data-area)──TARGETNUM(data-value)─┘

Conditions: INVREQ, NOTAUTH

FEPI DELETE POOL
──FEPI DELETE──POOL(data-value)────────────────────────────────────────────── ──┬──────────────────────────────────────────┬──────────────────────────────── └─NODELIST(data-area)──NODENUM(data-value)─┘ ──┬──────────────────────────────────────────────┬── └─TARGETLIST(data-area)──TARGETNUM(data-value)─┘

Conditions: INVREQ, NOTAUTH

FEPI DISCARD NODELIST
──FEPI DISCARD──NODELIST(data-area)──NODENUM(data-value)──

Conditions: INVREQ, NOTAUTH

FEPI DISCARD POOL
──FEPI DISCARD──POOL(data-value)──

Conditions: INVREQ, NOTAUTH

FEPI DISCARD PROPERTYSET
──FEPI DISCARD──PROPERTYSET(data-value)──

Conditions: INVREQ, NOTAUTH

218

CICS User’s Handbook

FEPI programming

FEPI DISCARD TARGETLIST
──FEPI DISCARD──TARGETLIST(data-area)──TARGETNUM(data-value)──

Conditions: INVREQ, NOTAUTH

FEPI INQUIRE CONNECTION
──FEPI INQUIRE CONNECTION──NODE(data-value)──TARGET(data-value)────────────── ──┬───────────────────┬──┬─────────────────┬──┬────────────────────┬────────── └─ACQNUM(data-area)─┘ └─ACQSTATUS(cvda)─┘ └─CONVNUM(data-area)─┘ ──┬───────────────────┬──┬────────────────────────┬──┬─────────────────┬────── └─INSTLSTATUS(cvda)─┘ └─LASTACQCODE(data-area)─┘ └─POOL(data-area)─┘ ──┬──────────────────┬──┬─────────────┬──┬─────────────────────┬────────────── └─SERVSTATUS(cvda)─┘ └─STATE(cvda)─┘ └─USERDATA(data-area)─┘ ──┬────────────────────────┬── └─WAITCONVNUM(data-area)─┘

Conditions: END, ILLOGIC, INVREQ, NOTAUTH

FEPI INQUIRE NODE
──FEPI INQUIRE──NODE(data-value)──┬───────────────────┬────────────────────── └─ACQNUM(data-area)─┘ ──┬─────────────────┬──┬───────────────────┬──┬────────────────────────┬────── └─ACQSTATUS(cvda)─┘ └─INSTLSTATUS(cvda)─┘ └─LASTACQCODE(data-area)─┘ ──┬──────────────────┬──┬─────────────────────┬── └─SERVSTATUS(cvda)─┘ └─USERDATA(data-area)─┘

Conditions: END, ILLOGIC, INVREQ, NOTAUTH

FEPI INQUIRE POOL
──FEPI INQUIRE──POOL(data-value)──┬─────────────────────────┬──────────────── └─BEGINSESSION(data-area)─┘ ──┬──────────────────┬──┬──────────────┬──┬───────────────────────┬─────────── └─CONTENTION(cvda)─┘ └─DEVICE(cvda)─┘ └─ENDSESSION(data-area)─┘ ──┬───────────────────────┬──┬────────────────────────┬──┬──────────────┬───── └─EXCEPTIONQ(data-area)─┘ └─FJOURNALNUM(data-area)─┘ └─FORMAT(cvda)─┘ ──┬───────────────────┬──┬───────────────────┬──┬───────────────────────┬───── └─INITIALDATA(cvda)─┘ └─INSTLSTATUS(cvda)─┘ └─MAXFLENGTH(data-area)─┘ ──┬───────────────┬──┬────────────────────────┬──┬──────────────────┬───────── └─MSGJRNL(cvda)─┘ └─PROPERTYSET(data-area)─┘ └─SERVSTATUS(cvda)─┘ ──┬─────────────────┬──┬──────────────────────┬──┬───────────────────┬──────── └─STSN(data-area)─┘ └─UNSOLDATA(data-area)─┘ └─UNSOLDATACK(cvda)─┘ ──┬─────────────────────┬──┬────────────────────────┬── └─USERDATA(data-area)─┘ └─WAITCONVNUM(data-area)─┘

Conditions: END, ILLOGIC, INVREQ, NOTAUTH

Chapter 6. FEPI command reference

219

FEPI programming

FEPI INQUIRE PROPERTYSET
──FEPI INQUIRE──PROPERTYSET(data-value)──┬─────────────────────────┬───────── └─BEGINSESSION(data-area)─┘ ──┬──────────────────┬──┬──────────────┬──┬───────────────────────┬─────────── └─CONTENTION(cvda)─┘ └─DEVICE(cvda)─┘ └─ENDSESSION(data-area)─┘ ──┬───────────────────────┬──┬────────────────────────┬──┬──────────────┬───── └─EXCEPTIONQ(data-area)─┘ └─FJOURNALNUM(data-area)─┘ └─FORMAT(cvda)─┘ ──┬───────────────────┬──┬───────────────────────┬──┬───────────────┬───────── └─INITIALDATA(cvda)─┘ └─MAXFLENGTH(data-area)─┘ └─MSGJRNL(cvda)─┘ ──┬─────────────────┬──┬──────────────────────┬──┬───────────────────┬── └─STSN(data-area)─┘ └─UNSOLDATA(data-area)─┘ └─UNSOLDATACK(cvda)─┘

Conditions: END, ILLOGIC, INVREQ, NOTAUTH

FEPI INQUIRE TARGET
──FEPI INQUIRE──TARGET(data-value)──┬─────────────────┬────────────────────── └─APPL(data-area)─┘ ──┬───────────────────┬──┬──────────────────┬──┬─────────────────────┬── └─INSTLSTATUS(cvda)─┘ └─SERVSTATUS(cvda)─┘ └─USERDATA(data-area)─┘

Conditions: END, ILLOGIC, INVREQ, NOTAUTH

FEPI INSTALL NODELIST
──FEPI INSTALL──NODELIST(data-area)──NODENUM(data-value)───────────────────── ┌─ACQUIRED────────┐ ┌─INSERVICE────────┐ ──┼─────────────────┼──┬─────────────────────────┬──┼──────────────────┼── ├─ACQSTATUS(cvda)─┤ └─PASSWORDLIST(data-area)─┘ ├─SERVSTATUS(cvda)─┤ └─RELEASED────────┘ └─OUTSERVICE───────┘

Conditions: INVREQ, NOTAUTH

FEPI INSTALL POOL
──FEPI INSTALL──POOL(data-value)──PROPERTYSET(data-value)──────────────────── ┌─ACQUIRED────────┐ ──┼─────────────────┼──┬──────────────────────────────────────────┬─────────── ├─ACQSTATUS(cvda)─┤ └─NODELIST(data-area)──NODENUM(data-value)─┘ └─RELEASED────────┘ ┌─INSERVICE────────┐ ──┼──────────────────┼──┬──────────────────────────────────────────────┬── ├─SERVSTATUS(cvda)─┤ └─TARGETLIST(data-area)──TARGETNUM(data-value)─┘ └─OUTSERVICE───────┘

Conditions: INVREQ, NOTAUTH

220

CICS User’s Handbook

FEPI programming

FEPI INSTALL PROPERTYSET
──FEPI INSTALL──PROPERTYSET(data-value)──┬──────────────────────────┬──────── └─BEGINSESSION(data-value)─┘ ┌─LOSE─────────────┐ ┌─T3278M2──────┐ ──┼──────────────────┼──┼──────────────┼──┬────────────────────────┬────────── ├─CONTENTION(cvda)─┤ ├─DEVICE(cvda)─┤ └─ENDSESSION(data-value)─┘ └─WIN──────────────┘ ├─T3278M3──────┤ ├─T3278M4──────┤ ├─T3278M5──────┤ ├─T3279M2──────┤ ├─T3279M3──────┤ ├─T3279M4──────┤ ├─T3279M5──────┤ ├─TPS55M2──────┤ ├─TPS55M3──────┤ ├─TPS55M4──────┤ └─LUP──────────┘ ──┬────────────────────────┬──┬─────────────────────────┬───────────────────── └─EXCEPTIONQ(data-value)─┘ └─FJOURNALNUM(data-value)─┘ ┌─FORMATTED────┐ ┌─NOTINBOUND────────┐ ──┼──────────────┼──┼───────────────────┼──┬────────────────────────┬───────── ├─FORMAT(cvda)─┤ ├─INITIALDATA(cvda)─┤ └─MAXFLENGTH(data-value)─┘ └─DATASTREAM───┘ └─INBOUND───────────┘ ┌─NOMSGJRNL─────┐ ──┼───────────────┼──┬──────────────────┬───────────────────────────────────── ├─MSGJRNL(cvda)─┤ └─STSN(data-value)─┘ ├─INPUT─────────┤ ├─OUTPUT────────┤ └─INOUT─────────┘ ──┬──────────────────────────────────────────────┬── │ ┌─NEGATIVE──────────┐ │ └─UNSOLDATA(data-value)─┼─UNSOLDATACK(cvda)─┼──┘ └─POSITIVE──────────┘

Conditions: INVREQ, NOTAUTH

FEPI INSTALL TARGETLIST
──FEPI INSTALL──TARGETLIST(data-area)──APPLLIST(data-area)─────────────────── ┌─INSERVICE────────┐ ──TARGETNUM(data-value)──┼──────────────────┼── ├─SERVSTATUS(cvda)─┤ └─OUTSERVICE───────┘

Conditions: INVREQ, NOTAUTH

Chapter 6. FEPI command reference

221

FEPI programming

FEPI SET CONNECTION
──FEPI SET CONNECTION──┬─NODE(data-value)─────────────────────────┬────────── └─NODELIST(data-area)──NODENUM(data-value)─┘ ──┬─TARGET(data-value)───────────────────────────┬──┬─────────────────┬─────── └─TARGETLIST(data-area)──TARGETNUM(data-value)─┘ ├─ACQSTATUS(cvda)─┤ ├─ACQUIRED────────┤ └─RELEASED────────┘ ──┬──────────────────┬──┬──────────────────────┬── ├─SERVSTATUS(cvda)─┤ └─USERDATA(data-value)─┘ ├─INSERVICE────────┤ └─OUTSERVICE───────┘

Conditions: INVREQ, NOTAUTH

FEPI SET NODE
──FEPI SET──┬─NODE(data-value)─────────────────────────┬───────────────────── └─NODELIST(data-area)──NODENUM(data-value)─┘ ──┬─────────────────┬──┬──────────────────┬──┬──────────────────────┬── ├─ACQSTATUS(cvda)─┤ ├─SERVSTATUS(cvda)─┤ └─USERDATA(data-value)─┘ ├─ACQUIRED────────┤ ├─INSERVICE────────┤ └─RELEASED────────┘ └─OUTSERVICE───────┘

Conditions: INVREQ, NOTAUTH

FEPI SET POOL
──FEPI SET──┬─POOL(data-value)─────────────────────────┬───────────────────── └─POOLLIST(data-area)──POOLNUM(data-value)─┘ ──┬──────────────────┬──┬──────────────────────┬── ├─SERVSTATUS(cvda)─┤ └─USERDATA(data-value)─┘ ├─INSERVICE────────┤ └─OUTSERVICE───────┘

Conditions: INVREQ, NOTAUTH

FEPI SET TARGET
──FEPI SET──┬─TARGET(data-value)───────────────────────────┬───────────────── └─TARGETLIST(data-area)──TARGETNUM(data-value)─┘ ──┬──────────────────┬──┬──────────────────────┬── ├─SERVSTATUS(cvda)─┤ └─USERDATA(data-value)─┘ ├─INSERVICE────────┤ └─OUTSERVICE───────┘

Conditions: INVREQ, NOTAUTH

222

CICS User’s Handbook

FEPI programming

FEPI SP NOOP
──FEPI SP NOOP──

Conditions: INVREQ, NOTAUTH

Chapter 6. FEPI command reference

223

FEPI programming

224

CICS User’s Handbook

Chapter 7. CICS-value data areas used by all commands
This section lists the CICS-value data-area (CVDA) values and their numeric equivalents for all of the EXEC CICS commands. CVDAs are described in the 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 sequence
CVDA ABEND ACQFAIL ACQUIRED ACQUIRING ACTIVE ACTIVITY ADD ADDABLE ADDFAIL ADVANCE ALARM ALLCONN ALLOCATED ALLQUERY ALTERABLE ALTERNATE ALTPRTCOPY AND ANY APLKYBD APLTEXT APPC APPCPARALLEL APPCSINGLE APPEND APPLICATION ASACTL ASCII7 ASCII8 Value 900 515 69 71 181 1002 291 41 519 265 501 169 81 431 52 197 446 1005 158 391| 393 124 374 373 1036 559| 224 616 617 CVDA ASSEMBLER ATI ATTENTION AUDALARM AUTOACTIVE AUTOARCH AUTOCONN AUTOINACTIVE AUTOPAGEABLE AUTOSTART AUXILIARY AUXPAUSE AUXSTART AUXSTOP AVAILABLE BACKOUT BACKTRANS BACKUPNONBWO BASE BASEAPI BASESPACE BDAM BEGINSESSION BELOW BGAM BINARY BLK BLOCKED BROWSABLE Value 150 75 524 395 630 262 170 631 80 618 247 313 312 314 95 192 397 800 10 1052 664 2 510 159 63 1038 47 16 39

|

|

|

© Copyright IBM Corp. 1989, 1999

225

CVDA BSAM BTAM BUSY C CACHE CANCEL CANCELLED CANCELLING CD CEDF CFTABLE CGROUP CICS CICSDATAKEY CICSEXECKEY CICSTABLE CKOPEN CLEAR CLIENTAUTH CLOSED CLOSELEAVE CLOSEREQUEST CLOSING CMDPROT CMDSECNO CMDSECYES COBOL COBOLII COLD COLDACQ COLDQUERY COLDSTART COLOR COMMIT COMMITFAIL COMPLETE COMPOSITE CONFFREE CONFRECEIVE CONFSEND CONNECT CONNECTED CONNECTING CONNECTION CONSISTENT CONSOLE CONTENTION CONTROLSHUT

Value 61 62 612 149 791 526 624 1025 491 370 833 902 660 379 381 101 1055 640 1032 19 261 22| 21 673 205 207 151 375 788 72 433| 266 399 208 792 1026 1003 82 83 84 903 690 904 755 723 66| 836 623

CVDA CONVERSE CONVIDLE COORDINATOR COPID COPY CREATE CSIGN CTERM CTLGALL CTLGMODIFY CTLGNONE CTRLABLE CTX CURRENT CUSERID DAE DATA DATASET DATASETFULL DATASTREAM DEADLOCK DEBUG DEC DEFAULT DEFRESP1 DEFRESP1OR2 DEFRESP2 DEFRESP3 DELAY DELETABLE DELETE DELETEFAIL DELEXITERROR DEREGERROR DEREGISTERED DEST DISABLED DISABLING DISCARDFAIL DISCREQ DISCONNING DISK1 DISK2 DISK2PAUSE DISPATCHABLE DORMANT DPLSUBSET DS3270

Value 600 518 770 908 401 67 905 906 632 633 634 56 907 260 909 684 508 756 793 543 794 1082 46 198 497 528 498 499 637 43 292 520 795 679 678 235 24 25 513 444 910 252 253 254 228 1024 383 615

|

|

| |

| |

|

226

CICS User’s Handbook

CVDA DUALCASE DUMMY DYNAMIC EB EBCDIC EMERGENCY EMPTY EMPTYREQ ENABLED ENDAFFINITY EQUAL ESDS EVENT EVENTFAIL EXCEPT EXCEPTRESP EXCI EXCTL EXECENQ EXECENQADDR EXIT EXITTRACE EXPIRED EXTENDEDDS EXTRA EXTSECURITY FAILED FAILEDBKOUT FAILINGBKOUT FCLOSE FINALQUIESCE FINPUT FIRED FIRSTINIT FIRSTQUIESCE FIXED FLUSH FMH FMHPARM FOPEN FORCE FORCECANCEL FORCECLOSE FORCECLOSING FORCED FORCEPURGE FORMATEDF FORMATTED

Value 403 781 178 490 1039 268 210| 31 23 790 911 5 334 1012 332 523 650 48 751 752 912 362| 1017| 405 221 194 782 357 358 273 183| 270 1001 625 182 12 783 502 385 272 342 655 351| 353 1013 237 606 542

CVDA FORMFEED FOUTPUT FREE FREEING FULL FULLAPI FULLAUTO FWDRECOVABLE GENERIC GMT GOINGOUT GROUP GTFSTART GTFSTOP HEURBACKOUT HEURCOMMIT HEX HFORM HIGH HILIGHT HOLD HTTPNO HTTPYES IGNORE IGNORERR IMMCLOSE IMMCLOSING IMMQUIESCED INACTIVE INBOUND INCOMPLETE INDEXRECFULL INDIRECT INDOUBT INFLIGHT INITCOMPLETE INITIAL INOUT INPUT INSERVICE INSTALLED INSTALLFAIL INTERNAL INTRA INTSTART INTSTOP INVALID IOERROR

Value 407 271 85 94 212 384 1073 354 651 604 172 913 317 318 758 757 45 409 914 413 163 1034 1033 1 816 350 352 706 378 547 1014 796 122 620 621 628 789 532 226 73 550 512 1058 222 310 311 359 797

|

|

|

|

|

|

Chapter 7. CICS-value data areas used by all commands

227

CVDA IRC ISOLATE JVM KATAKANA KEYED KSDS LCKSTRUCFULL LEAVE LE370 LIC LIGHTPEN LOAD LOCAL LOCKING LOG LOGICAL LOGTERM LOSE LOW LPA LUP LUSTAT LU61 MAIN MAP MAPSET MCHCTL MDT MOD MODEL MORE MSRCONTROL MVS NEGATIVE NEWCOPY NEWSESSION NOALARM NOALTPRTCOPY NOAPLKYBD NOAPLTEXT NOAPPEND NOATI NOAUDALARM NOAUTO NOAUTOARCH NOBACKTRANS NOCEDF NOCLEAR

Value 121 658 1080 415 8 6 832 811 377 493| 417 834 605 837 54 216 269 544 915 165 541 525| 125 248 155 155 241 506 813| 370 492 419| 780 530 167 485 500 447 392 394 1037| 76 396 1071 263 398 371 641

CVDA NOCMDPROT NOCOLOR NOCONNECT NOCONV NOCONVERSE NOCOPY NOCREATE NOCTL NODAE NODEBUG NODISCREQ NODUALCASE NOEMPTYREQ NOEVENT NOEXCEPT NOEXCTL NOEXIT NOEXITTRACE NOEXTENDEDDS NOFMH NOFMHPARM NOFORCE NOFORMATEDF NOFORMFEED NOHFORM NOHILIGHT NOHOLD NOISOLATE NOJVM NOKATAKANA NOLIGHTPEN NOLOAD NOLOG NOLOSTLOCKS NOMDT NOMSGJRNL NOMSRCONTROL NONAUTOCONN NONCICS NONE NONLE370 NOOBFORMAT NOOBOPERID NOOUTLINE NOPARTITIONS NOPERF NOPRESETSEC NOPRINTADAPT

Value 674 400 916 556 601 402 68 223 685 1083 445 404 32 335 333 49 917 363 406 503 386 1054 607 408 410 414 164 657 1081 416 418 835 55 710 507 531 420 171 661 496 1084 422 388 424 426 331 243 428

|

|

| |

|

|

228

CICS User’s Handbook

CVDA NOPROGSYMBOL NOPRTCOPY NOQUERY NORECOVDATA NOREENTPROT NORELEASE NORELREQ NORETAINED NORMAL NORMALBKOUT NORMALRESP NOROLLBACK NOSECURITY NOSHUTDOWN NOSOSI NOSPI NOSSL NOSTSN NOSWITCH NOSYNCPOINT NOSYSCONNECT NOSYSDUMP NOSYSLOG NOTADDABLE NOTALTERABLE NOTAPPLIC NOTASKSTART NOTBROWSABLE NOTBUSY NOTCDEB NOTCONNECTED NOTCTRLABLE NOTDEFINED NOTDELETABLE NOTDYNAMIC NOTEMPTY NOTERMINAL NOTEXTKYBD NOTEXTPRINT NOTFIRED NOTFWDRCVBLE NOTINBOUND NOTINIT NOTINSTALLED NOTKEYED NOTLPA NOTPENDING NOTPURGEABLE

Value 430 449 432 700 681 918 443| 711 1016 356| 522 919 196 289 435 694| 1031 487 285 603 654 185 784 42 53 1 608 40 613 495 691 57 659 44 1021| 211 214 437 439 1000| 361 546 376 551 9 166 127 161

CVDA NOTRANDUMP NOTREADABLE NOTREADY NOTRECOVABLE NOTREQUIRED NOTRLS NOTROUTABLE NOTSOS NOTSUPPORTED NOTSUSPENDED NOTTABLE NOTTI NOTUPDATABLE NOTWAIT NOUCTRAN NOUSER NOVALIDATION NOVFORM NOWAIT NOWRITE NOZCPTRACE NRS N906 N906D OBFORMAT OBOPERID OBTAINING OFF OK OLD OLDCOPY OLDSESSION ON OPEN OPENAPI OPENERROR OPENING OPENOUTPUT OPID OR OUTLINE OUTPUT OUTSERVICE OWNER PAGEABLE PARTITIONS PARTITIONSET PATH

Value 187 36 259 30 667 721 1022 669 15 1027 100 78 38 920 451 1011 441 412 341 275 365 774 931 921 421 387 96 200 274 26 162 486 201 18 1053 798 20 257 933 1006 423 227 74 753 79 425 156 11

|

|

|

|

Chapter 7. CICS-value data areas used by all commands

229

CVDA PENDBEGIN PENDDATA PENDFREE PENDING PENDPASS PENDRECEIVE PENDRELEASE PENDSTART PENDSTSN PENDUNSOL PERF PHASEIN PHYSICAL PLI PL1 POOL POSITIVE POST PRESETSEC PRIMARY PRINTADAPT PRIVATE PROCESS PROGAUTO PROGRAM PROGSYMBOL PROTECTED PRTCOPY PURGE PURGEABLE QUASIRENT QUEUE QUIESCED QUIESCING QR READABLE READBACK READONLY READY REBUILD RECEIVE RECONNECT RECOVDATA RECOVERABLE RECOVERED RECOVERLOCKS REENTPROT REGERROR

Value 558 560 86 126 565 87 562 561 557 564 330 168| 215 152 152 922 529 636| 242 110 427 174 1010 1072 154 429 504 448 236 160 1050 814 707 708| 1057| 35 209| 275 258 923 88 924 701 29 277 712 680 677

CVDA REGISTERED REJECT RELATED RELEASE RELEASED RELEASING RELREQ REMLOSTLOCKS REMOTE REMOVE REMSESSION REMTABLE REPEATABLE REQUIRED REREAD RESET RESETLOCKS RESSECINT RESSECNO RESSECYES RESYNC RETAINED RETRY REVERTED REWIND RLS RLSACTIVE RLSGONE RLSINACTIVE RLSSERVER RMI ROLLBACK ROUTE ROUTABLE RRCOMMITFAIL RRDS RRINDOUBT RTR RU RUNNING SCS SECONDINIT SEND SESSION SESSIONFAIL SESSIONLOST SETFAIL SHARE

Value 670 815 675 563 70 549 442 713 4 276 740 103 724 666 812 290 714 203 202 204 702 715 716 264 811 720 730 799 731 761 771 89 638 1023 830 7 831 527 494 229 614 626 90 372 517 516 514 27

| |

|

|

230

CICS User’s Handbook

CVDA SHARED SHUNTED SHUTDISABLED SHUTDOWN SHUTENABLED SIGN SIGNEDOFF SIGNEDON SINGLEOFF SINGLEON SKIP SMF SOS SOSABOVE SOSBELOW SOSI SPECIFIC SPECTRACE SPI SPRSTRACE SQLCODE SSL STANDBY STANTRACE START STARTED STARTING STARTUP STATIC STOPPED STSN STSNSET STSNTEST SUBORDINATE SUBSPACE SURROGATE SUSPENDED SWITCH SWITCHALL SWITCHING SWITCHNEXT SYNCFREE SYNCPOINT SYNCRECEIVE SYNCSEND SYSCONNECT SYSDUMP SYSLOG

Value 173 762 645 288 644 925 245 244 324 323 810 255 668 683 682 434 652 177 693 175 926| 1030 629| 176 635 609 772 180 179 610 509 488 489 773 663 371 231 188 287 225 286 91 602 92| 93| 653 184 785

CVDA SYSTEM SYSTEMOFF SYSTEMON TAKEOVER TAPE1 TAPE2 TASK TASKSTART TCAM TCAMSNA TCEXITALL TCEXITALLOFF TCEXITNONE TCEXITSYSTEM TDQ TERM TERMINAL TEXTKYBD TEXTPRINT THIRDINIT THREADSAFE TIMEOUT TIMER TPOOL TPS55M3 TPS55M4 TPS55M5 TRANDUMP TRANIDONLY TSQ TTI TX TXID TWAIT T3278M2 T3278M3 T3278M4 T3278M5 T3279M2 T3279M3 T3279M4 T3279M5 UCTRAN UKOPEN UNATTEMPTED UNAVAILABLE UNBLOCKED UNCOMMITTED

Value 643 320 319 111 250 251 233 611 64 65 366 369 368 367 767 234 213 436 438 627 1051 511 1004 932 553 554 555 186 452 768 77 929 928 927 533 534 535 536 537 538 539 540 450 1056 820 672 17 722

|

|

Chapter 7. CICS-value data areas used by all commands

231

CVDA
|

Value 703 14 355 33 34 1015 1018 505 709 671 521 246 37 642 380 382 930 322 321 102 360 440 13 411 732 3 60 340 763 754 622 765 766 267 545 665 123 144 143 364

| | |

|

UNCONNECTED UNDEFINED UNDETERMINED UNENABLED UNENABLING UNEXPECTED UNEXPIRED UNPROTECTED UNQUIESCED UNREGISTERED UNSOLDATA UOW UPDATABLE USER USERDATAKEY USEREXECKEY USERID USEROFF USERON USERTABLE VALID VALIDATION VARIABLE VFORM VRRDS VSAM VTAM WAIT WAITCOMMIT WAITER WAITFORGET WAITING WAITRMI WARMSTART WIN XCF XM XNOTDONE XOK ZCPTRACE

232

CICS User’s Handbook

CVDAs and numeric values in numeric sequence
Value 1 1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 16 17 18 19 20 21 22 23 24 25 26 27 29 30 31 32 33 34 35 36 37 38 39 40 41 42 43 44 45 46 CVDA IGNORE NOTAPPLIC BDAM VSAM REMOTE ESDS KSDS RRDS KEYED NOTKEYED BASE PATH FIXED VARIABLE UNDEFINED NOTSUPPORTED BLOCKED UNBLOCKED OPEN CLOSED OPENING CLOSING CLOSEREQUEST ENABLED DISABLED DISABLING OLD SHARE RECOVERABLE NOTRECOVABLE EMPTYREQ NOEMPTYREQ UNENABLED UNENABLING READABLE NOTREADABLE UPDATABLE NOTUPDATABLE BROWSABLE NOTBROWSABLE ADDABLE NOTADDABLE DELETABLE NOTDELETABLE HEX DEC Value 47 48 49 52 53 54 55 56 57 60 61 62 63 64 65 66 67 68 69 70 71 72 73 74 75 76 77 78 79 80 81 82 83 84 85 86 87 88 89 90 91 92 93 94 95 96 CVDA BLK EXCTL NOEXCTL ALTERABLE NOTALTERABLE LOG NOLOG CTRLABLE NOTCTRLABLE VTAM BSAM BTAM BGAM TCAM TCAMSNA CONSOLE CREATE NOCREATE ACQUIRED RELEASED ACQUIRING COLDACQ INSERVICE OUTSERVICE ATI NOATI TTI NOTTI PAGEABLE AUTOPAGEABLE ALLOCATED CONFFREE CONFRECEIVE CONFSEND FREE PENDFREE PENDRECEIVE RECEIVE ROLLBACK SEND SYNCFREE SYNCRECEIVE SYNCSEND FREEING AVAILABLE OBTAINING

|

Chapter 7. CICS-value data areas used by all commands

233

Value 100 101 102 103 110 111 121 122 123 124 125 126 127 143 144 149 150 151 152 152 154 155 155 156 158 159 160 161 162 163 164 165 166 167 168 169 170 171 172 173 174 175 176 177 178 179 180 181

CVDA NOTTABLE CICSTABLE USERTABLE REMTABLE PRIMARY TAKEOVER IRC INDIRECT XM APPC LU61 PENDING NOTPENDING XOK XNOTDONE C ASSEMBLER COBOL PLI PL1 PROGRAM MAP MAPSET PARTITIONSET ANY BELOW PURGEABLE NOTPURGEABLE OLDCOPY HOLD NOHOLD LPA NOTLPA NEWCOPY PHASEIN ALLCONN AUTOCONN NONAUTOCONN GOINGOUT SHARED PRIVATE SPRSTRACE STANTRACE SPECTRACE DYNAMIC STATIC STARTUP ACTIVE

Value 182 183 184 185 186 187 188 192 194 196 197 198 200 201 202 203 204 205 207 208 209 210 211 212 213 214 215 216 221 222 223 224 225 226 227 228 229 231 233 234 235 236 237 241 242 243 244 245

CVDA FIRSTQUIESCE FINALQUIESCE SYSDUMP NOSYSDUMP TRANDUMP NOTRANDUMP SWITCH BACKOUT EXTSECURITY NOSECURITY ALTERNATE DEFAULT OFF ON RESSECNO RESSECINT RESSECYES CMDSECNO CMDSECYES COMMIT READBACK EMPTY NOTEMPTY FULL TERMINAL NOTERMINAL PHYSICAL LOGICAL EXTRA INTRA NOCTL ASACTL SWITCHING INPUT OUTPUT DISPATCHABLE RUNNING SUSPENDED TASK TERM DEST PURGE FORCEPURGE MCHCTL PRESETSEC NOPRESETSEC SIGNEDON SIGNEDOFF

|

|

234

CICS User’s Handbook

Value
|

CVDA UOW AUXILIARY MAIN TAPE1 TAPE2 DISK1 DISK2 DISK2PAUSE SMF OPENOUTPUT READY NOTREADY CURRENT CLOSELEAVE AUTOARCH NOAUTOARCH REVERTED ADVANCE COLDSTART WARMSTART EMERGENCY LOGTERM FINPUT FOUTPUT FOPEN FCLOSE OK NOWRITE READONLY REMOVE RECOVERED NOSWITCH SWITCHNEXT SWITCHALL SHUTDOWN NOSHUTDOWN RESET ADD DELETE INTSTART INTSTOP AUXSTART AUXPAUSE AUXSTOP GTFSTART GTFSTOP SYSTEMON SYSTEMOFF

Value 321 322 323 324 330 331 332 333 334 335 340 341 342 350 351 352 353 354 355 356 357 358 359 360 361 362 363 364 365 366 367 368 369 370 370 371 371 372 373 374 375 376 377 378 379 380 381 382

CVDA USERON USEROFF SINGLEON SINGLEOFF PERF NOPERF EXCEPT NOEXCEPT EVENT NOEVENT WAIT NOWAIT FORCE IMMCLOSE FORCECLOSE IMMCLOSING FORCECLOSING FWDRECOVABLE UNDETERMINED NORMALBKOUT FAILEDBKOUT FAILINGBKOUT INVALID VALID NOTFWDRCVBLE EXITTRACE NOEXITTRACE ZCPTRACE NOZCPTRACE TCEXITALL TCEXITSYSTEM TCEXITNONE TCEXITALLOFF CEDF MODEL NOCEDF SURROGATE SESSION APPCSINGLE APPCPARALLEL COBOLII NOTINIT LE370 INACTIVE CICSDATAKEY USERDATAKEY CICSEXECKEY USEREXECKEY

|

246 247 248 250 251 252 253 254 255 257 258 259 260 261 262 263 264 265 266 267 268 269 270 271 272 273 274 275 275 276 277 285 286 287 288 289 290 291 292 310 311 312 313 314 317 318 319 320

Chapter 7. CICS-value data areas used by all commands

235

Value 383 384 385 386 387 388 391 392 393 394 395 396 397 398 399 400 401 402 403 404 405 406 407 408 409 410 411 412 413 414 415 416 417 418 419 420 421 422 423 424 425 426 427 428 429 430 431 432

CVDA DPLSUBSET FULLAPI FMHPARM NOFMHPARM OBOPERID NOOBOPERID APLKYBD NOAPLKYBD APLTEXT NOAPLTEXT AUDALARM NOAUDALARM BACKTRANS NOBACKTRANS COLOR NOCOLOR COPY NOCOPY DUALCASE NODUALCASE EXTENDEDDS NOEXTENDEDDS FORMFEED NOFORMFEED HFORM NOHFORM VFORM NOVFORM HILIGHT NOHILIGHT KATAKANA NOKATAKANA LIGHTPEN NOLIGHTPEN MSRCONTROL NOMSRCONTROL OBFORMAT NOOBFORMAT OUTLINE NOOUTLINE PARTITIONS NOPARTITIONS PRINTADAPT NOPRINTADAPT PROGSYMBOL NOPROGSYMBOL ALLQUERY NOQUERY

Value 433 434 435 436 437 438 439 440 441 442 443 444 445 446 447 448 449 450 451 452 485 486 487 488 489 490 491 492 493 494 495 496 497 498 499 500 501 502 503 504 505 506 507 508 509 510 511 512

CVDA COLDQUERY SOSI NOSOSI TEXTKYBD NOTEXTKYBD TEXTPRINT NOTEXTPRINT VALIDATION NOVALIDATION RELREQ NORELREQ DISCREQ NODISCREQ ALTPRTCOPY NOALTPRTCOPY PRTCOPY NOPRTCOPY UCTRAN NOUCTRAN TRANIDONLY NEWSESSION OLDSESSION NOSTSN STSNSET STSNTEST EB CD MORE LIC RU NOTCDEB NONE DEFRESP1 DEFRESP2 DEFRESP3 NOALARM ALARM FMH NOFMH PROTECTED UNPROTECTED MDT NOMDT DATA STSN BEGINSESSION TIMEOUT INSTALLFAIL

236

CICS User’s Handbook

Value 513 514 515 516 517 518 519 520 521 522 523 524 525 526 527 528 529 530 531 532 533 534 535 536 537 538 539 540 541 542 543 544 545 546 547 549 550 551 552 553 554 555 556 557 558 559 560 561

CVDA DISCARDFAIL SETFAIL ACQFAIL SESSIONLOST SESSIONFAIL CONVIDLE ADDFAIL DELETEFAIL UNSOLDATA NORMALRESP EXCEPTRESP ATTENTION LUSTAT CANCEL RTR DEFRESP1OR2 POSITIVE NEGATIVE NOMSGJRNL INOUT T3278M2 T3278M3 T3278M4 T3278M5 T3279M2 T3279M3 T3279M4 T3279M5 LUP FORMATTED DATASTREAM LOSE WIN NOTINBOUND INBOUND RELEASING INSTALLED NOTINSTALLED TPS55M2 TPS55M3 TPS55M4 TPS55M5 NOCONV PENDSTSN PENDBEGIN APPLICATION PENDDATA PENDSTART

Value 562 563 564 565 600 601 602 603 604 605 606 607 608 609 610 611 612 613 614 615 616 617 618 620 621 622 623 624 625 626 627 628 629 630 631 632 633 634 635 636 637 638 640 641 642 643 644 645

CVDA PENDRELEASE RELEASE PENDUNSOL PENDPASS CONVERSE NOCONVERSE SYNCPOINT NOSYNCPOINT GMT LOCAL FORMATEDF NOFORMATEDF NOTASKSTART STARTED STOPPED TASKSTART BUSY NOTBUSY SCS DS3270 ASCII7 ASCII8 AUTOSTART INDOUBT INFLIGHT WAITFORGET CONTROLSHUT CANCELLED FIRSTINIT SECONDINIT THIRDINIT INITCOMPLETE STANDBY AUTOACTIVE AUTOINACTIVE CTLGALL CTLGMODIFY CTLGNONE START POST DELAY ROUTE CLEAR NOCLEAR USER SYSTEM SHUTENABLED SHUTDISABLED

Chapter 7. CICS-value data areas used by all commands

237

Value 650 651 652 653 654 655 657 658 659 660 661 663 664 665 666 667 668 669 670 671 672 673 674 675 677 678 679 680 681 682 683 684 685 690 691 693 694 700 701 702 703 706 707 708 709 710 711 712

CVDA EXCI GENERIC SPECIFIC SYSCONNECT NOSYSCONNECT FORCECANCEL NOISOLATE ISOLATE NOTDEFINED CICS NONCICS SUBSPACE BASESPACE XCF REQUIRED NOTREQUIRED SOS NOTSOS REGISTERED UNREGISTERED UNAVAILABLE CMDPROT NOCMDPROT RELATED REGERROR DEREGISTERED DEREGERROR REENTPROT NOREENTPROT SOSBELOW SOSABOVE DAE NODAE CONNECTED NOTCONNECTED SPI NOSPI NORECOVDATA RECOVDATA RESYNC UNCONNECTED IMMQUIESCED QUIESCED QUIESCING UNQUIESCED NOLOSTLOCKS NORETAINED RECOVERLOCKS

Value 713 714 715 716 720 721 722 723 724 730 731 732 740 751 752 753 754 755 756 757 758 761 762 763 765 766 767 768 770 771 772 773 774 780 781 782 783 784 785 788 789 790 791 792 793 794 795 796

CVDA REMLOSTLOCKS RESETLOCKS RETAINED RETRY RLS NOTRLS UNCOMMITTED CONSISTENT REPEATABLE RLSACTIVE RLSINACTIVE VRRDS REMSESSION EXECENQ EXECENQADDR OWNER WAITER CONNECTION DATASET HEURCOMMIT HEURBACKOUT RLSSERVER SHUNTED WAITCOMMIT WAITING WAITRMI TDQ TSQ COORDINATOR RMI STARTING SUBORDINATE NRS MVS DUMMY FAILED FLUSH NOSYSLOG SYSLOG COLD INITIAL ENDAFFINITY CACHE COMMITFAIL DATASETFULL DEADLOCK DELEXITERROR INDEXRECFULL

238

CICS User’s Handbook

Value 797 798 799 800 810 811 811 812 813 814 815 816 820 830 831 832 833 834 835 836 837 900 902 903 904 905 906 907 908 909 910 911 912 913 914 915 916 917 918 919 920 921 922 923 924 925 926 927

CVDA IOERROR OPENERROR RLSGONE BACKUPNONBWO SKIP REWIND LEAVE REREAD MOD QUEUE REJECT IGNORERR UNATTEMPTED RRCOMMITFAIL RRINDOUBT LCKSTRUCFULL CFTABLE LOAD NOLOAD CONTENTION LOCKING ABEND CGROUP CONNECT CONNECTING CSIGN CTERM CTX COPID CUSERID DISCONNING EQUAL EXIT GROUP HIGH LOW NOCONNECT NOEXIT NORELEASE NOROLLBACK NOTWAIT N906D POOL REBUILD RECONNECT SIGN SQLCODE TWAIT

Value 928 929 930 931 932 933 1000 1001 1002 1003 1004 1005 1006 1010 1011 1012 1013 1014 1015 1016 1017 1018 1021 1022 1023 1024 1025 1026 1027 1030 1031 1032 1033 1034 1036 1037 1038 1039 1050 1051 1052 1053 1054 1055 1056 1057 1058 1071

CVDA TXID TX USERID N906 TPOOL OPID NOTFIRED FIRED ACTIVITY COMPOSITE TIMER AND OR PROCESS NOUSER EVENTFAIL FORCED INCOMPLETE UNEXPECTED NORMAL EXPIRED UNEXPIRED NOTDYNAMIC NOTROUTABLE ROUTABLE DORMANT CANCELLING COMPLETE NOTSUSPENDED SSL NOSSL CLIENTAUTH HTTPYES HTTPNO APPEND NOAPPEND BINARY EBCDIC QUASIRENT THREADSAFE BASEAPI OPENAPI NOFORCE CKOPEN UKOPEN QR INTERNAL NOAUTO

| | | | |

| | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | |

Chapter 7. CICS-value data areas used by all commands

239

Value
| | | | | | |

CVDA PROGAUTO FULLAUTO JVM NOJVM DEBUG NODEBUG NONLE370

1072 1073 1080 1081 1082 1083 1084

CVDA values for the DEVICE option
CVDA sequence BATCHLU BIPROG BISYNCH CDRDLPRT CONTNLU HARDCOPY INTACTLU ISCMMCONV LUCMODGRP LUCSESS LUTYPE4 LUTYPE6 MAGTAPE RESSYS SDLC SEQDISK SYSTEM3 SYSTEM7 SYS370 SYS7BSCA TCONSOLE TELETYPE TTCAM TWX3335 T1050 T1053 T2260L T2260R T2265 T2740 T2741BCD T2741COR T2770 T2780 T2980 T3275R 191 160 128 24 189 32 190 209 210 211 193 192 20 208 176 18 161 2 164 166 8 34 80 33 36 74 65 72 76 40 43 42 130 132 134 146 CVDA sequence T3277L T3277R T3284L T3284R T3286L T3286R T3600BI T3601 T3614 T3650ATT T3650PIPE T3650USER T3653HOST T3735 T3740 T3780 T3790 T3790SCSP T3790UP T7770 VIDEOTERM 153 145 155 147 156 148 138 177 178 186 184 187 185 136 137 133 180 182 181 1 64

240

CICS User’s Handbook

Numeric sequence 1 2 8 18 20 24 32 33 34 36 40 42 43 64 65 72 74 76 80 128 130 132 133 134 136 137 138 145 146 147 148 153 155 156 160 161 164 166 176 177 178 180 181 182 184 185 186 187 T7770 SYSTEM7 TCONSOLE SEQDISK MAGTAPE CDRDLPRT HARDCOPY TWX3335 TELETYPE T1050 T2740 T2741COR T2741BCD VIDEOTERM T2260L T2260R T1053 T2265 TTCAM BISYNCH T2770 T2780 T3780 T2980 T3735 T3740 T3600BI T3277R T3275R T3284R T3286R T3277L T3284L T3286L BIPROG SYSTEM3 SYS370 SYS7BSCA SDLC T3601 T3614 T3790 T3790UP T3790SCSP T3650PIPE T3653HOST T3650ATT T3650USER

Numeric sequence 189 190 191 192 193 208 209 210 211 CONTNLU INTACTLU BATCHLU LUTYPE6 LUTYPE4 RESSYS ISCMMCONV LUCMODGRP LUCSESS

Chapter 7. CICS-value data areas used by all commands

241

242

CICS User’s Handbook

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 EIBAID EIBATT EIBCALEN EIBCOMPL EIBCONF EIBCPOSN EIBDATE EIBDS EIBEOC EIBERR EIBERRCD EIBFMH EIBFN EIBFREE EIBNODAT EIBRCODE EIBRECV EIBREQID EIBRESP EIBRESP2 EIBRLDBK EIBRSRCE EIBSIG EIBSYNC EIBSYNRB EIBTASKN EIBTIME EIBTRMID EIBTRNID COBOL PIC X(1) PIC X(1) PIC S9(4) COMP PIC X(1) PIC X(1) PIC S9(4) COMP PIC S9(7) COMP-3 PIC X(8) PIC X(1) PIC X(1) PIC X(4) PIC X(1) PIC X(2) PIC X(1) PIC X(1) PIC X(6) PIC X(1) PIC X(8) PIC S9(8) COMP PIC S9(8) COMP PIC X(1) PIC X(8) PIC X(1) PIC X(1) PIC X(1) PIC S9(7) COMP-3 PIC S9(7) COMP-3 PIC X(4) PIC X(4) C/370 char eibaid[1] char eibatt[1] short int eibcalen char eibcompl[1] char eibconf[1] short int eibcposn char eibdate[4] char eibds[8] char eibeoc[1] char eiberr[1] char eiberrcd[4] char eibfmh[1] char eibfn[2] char eibfree[1] char eibnodat[1] char eibrcode[6] char eibrecv[1] char eibreqid[8] long int eibresp long int eibresp2 char char char char char char eibrldbk[1] eibrsrce[8] eibsig[1] eibsync[1] eibsynrb[1] eibtaskn[4] PL/I CHAR(1) CHAR(1) FIXED BIN(15) CHAR(1) CHAR(1) FIXED BIN(15) FIXED DEC(7,0) CHAR(8) CHAR(1) CHAR(1) CHAR(4) CHAR(1) CHAR(2) CHAR(1) CHAR(1) CHAR(6) CHAR(1) CHAR(8) FIXED BIN(31) FIXED BIN(31) CHAR(1) CHAR(8) CHAR(1) CHAR(1) CHAR(1) FIXED DEC(7,0) FIXED DEC(7,0) CHAR(4) CHAR(4) ASM CL1 CL1 H CL1 CL1 H PL4 CL8 CL1 CL1 CL4 CL1 CL2 CL1 CL1 CL6 CL1 CL8 F F CL1 CL8 CL1 CL1 CL1 PL4 PL4 CL4 CL4

char eibtime[4] char eibtrmid[4] char eibtrnid[4]

© Copyright IBM Corp. 1989, 1999

243

EIBFN codes

EIBFN codes
Note: In the column Type, API indicates that the command is described in the CICS Application Programming Reference, and SPI indicates that it is described in the CICS System Programming Reference manual. SPI does not indicate that the special (SP) translator option is required for this command. FEPI indicates commands used by the CICS/ESA Front End Programming Interface. They are described in the CICS Front End Programming Interface User's Guide.
EIBFN value X'0202' X'0204' X'0206' X'0208' X'020A' X'020C' X'020E' X'0210' X'0402' X'0404' X'0406' X'0408' X'040A' X'040C' X'040E' X'0410' X'0412' X'0414' X'0416' X'0418' X'041A' X'041C' X'041E' X'0420' Command ADDRESS HANDLE CONDITION HANDLE AID ASSIGN IGNORE CONDITION PUSH POP ADDRESS SET RECEIVE SEND CONVERSE ISSUE EODS ISSUE COPY WAIT TERMINAL ISSUE LOAD WAIT SIGNAL ISSUE RESET ISSUE DISCONNECT ISSUE ENDOUTPUT ISSUE ERASEAUP ISSUE ENDFILE ISSUE PRINT ISSUE SIGNAL ALLOCATE Type API API API API API API API API API API API API API API API API API API API API API API API API EIBFN value X'0422' X'0424' X'0426' X'0428' X'042A' X'042C' X'042E' X'0430' X'0432' X'0434' X'0436' X'0438' X'043A' X'043C' X'043E' X'0602' X'0604' X'0606' X'0608' X'060A' X'060C' X'060E' X'0610' X'0612' X'0614' X'0802' X'0804' X'0806' X'0A02' X'0A04' X'0A06' X'0C02' X'0C04' X'0E02' X'0E04' X'0E06' X'0E08' X'0E0A' X'0E0C' X'0E0E' X'1002' X'1004' Command FREE POINT BUILD ATTACH EXTRACT ATTACH EXTRACT TCT WAIT CONVID EXTRACT PROCESS ISSUE ABEND CONNECT PROCESS ISSUE CONFIRMATION ISSUE ERROR ISSUE PREPARE ISSUE PASS EXTRACT LOGONMSG EXTRACT ATTRIBUTES READ WRITE FILE REWRITE DELETE UNLOCK STARTBR READNEXT READPREV ENDBR RESETBR WRITEQ TD READQ TD DELETEQ TD WRITEQ TS READQ TS DELETEQ TS GETMAIN FREEMAIN LINK XCTL LOAD RETURN RELEASE ABEND HANDLE ABEND ASKTIME DELAY Type API API API API API API API API API API API API API API API API API API API API API API API API API API API API API API API API API API API API API API API API API API

244

CICS User’s Handbook

EIBFN codes
EIBFN value X'1006' X'1008' X'100A' X'100C' X'1202' X'1204' X'1206' X'1208' X'1402' X'1404' X'1406' X'1408' X'1602' X'1604' X'1802' X'1804' X'1806' X'1808' X'180A' X'180C' X'180E' X'1810' X'1812' X'1C02' X'1E02' X'1E04' X'1E06' X'1E08' X'1E0A' X'1E0C' X'1E0E' X'1E10' X'1E12' X'1E14' X'2002' X'2202' X'2204' X'2206' X'2402' X'2404' X'2406' X'2408' X'240A' X'240C' Command POST START RETRIEVE CANCEL WAIT EVENT ENQ DEQ SUSPEND WRITE JOURNALNUM WAIT JOURNALNUM WRITE JOURNALNAME WAIT JOURNALNAME SYNCPOINT RESYNC ENTRYNAME RECEIVE MAP SEND MAP SEND TEXT SEND PAGE PURGE MESSAGE ROUTE RECEIVE PARTN SEND PARTNSET SEND CONTROL DUMP ISSUE ADD ISSUE ERASE ISSUE REPLACE ISSUE ABORT ISSUE QUERY ISSUE END ISSUE RECEIVE ISSUE NOTE ISSUE WAIT ISSUE SEND BIF DEEDIT ENABLE PROGRAM DISABLE EXTRACT EXIT ALLOCATE ASSIGN EXTRACT PROCESS FREE ISSUE ABEND CONNECT PROCESS Type API API API API API API API API API API API API API SPI API API API API API API API API API API API API API API API API API API API API API SPI API SPI API API API API API API EIBFN value Command Type API API API API API API API API SPI SPI SPI SPI SPI SPI SPI SPI SPI SPI SPI SPI SPI SPI SPI SPI SPI SPI SPI SPI SPI SPI SPI SPI SPI SPI SPI

X'240E' ISSUE CONFIRMATION X'2410' ISSUE ERROR X'2412' ISSUE SIGNAL X'2414' RECEIVE X'2416' SEND X'2418' WAIT X'241A' ISSUE PREPARE X'241C' EXTRACT ATTRIBUTES X'3002' CREATE PROGRAM X'3004' CREATE MAPSET X'3006' CREATE PARTITIONSET X'3008' CREATE TRANSACTION X'300A' CREATE PROFILE X'300C' CREATE TYPETERM X'300E' CREATE CONNECTION X'3010' CREATE TERMINAL X'3012' CREATE SESSIONS X'3014' CREATE FILE X'3016' CREATE LSRPOOL X'3018' CREATE PARTNER X'301A' CREATE TRANCLASS X'301C' CREATE TDQUEUE X'301E' CREATE JOURNALMODEL X'3020' CREATE DB2CONN X'3022' CREATE DB2ENTRY X'3024' CREATE DB2TRAN X'3026' CREATE PROCESSTYPE X'3028' CREATE TSMODEL X'302A' CREATE ENQMODEL X'302C' CREATE REQUESTMODEL X'302E' CREATE DOCTEMPLATE X'3030' CREATE TCPIPSERVICE X'3A02' INQ RRMS X'4202' INQUIRE AUTINSTMODEL X'4210' DISCARD AUTINSTMODEL

Chapter 8. EXEC interface block (EIB)

245

EIBFN codes
EIBFN value X'4402' X'4410' X'4602' X'4610' X'4802' X'4804' X'4A02' X'4A04' X'4C02' X'4C04' X'4C10' X'4E02' X'4E04' X'4E10' X'5002' X'5004' X'5010' X'5202' X'5204' X'5206' X'5208' X'5210' X'5212' X'5214' X'5216' X'5402' X'5404' X'5412' X'5602' X'5602' X'5604' X'5606' X'5610' X'5802' X'5804' X'5806' X'5810' X'5A02' X'5A04' X'5C02' X'5C04' Command INQUIRE PARTNER DISCARD PARTNER INQUIRE PROFILE DISCARD PROFILE ENTER TRACENUM MONITOR ASKTIME ABSTIME FORMATTIME INQUIRE FILE SET FILE DISCARD FILE INQUIRE PROGRAM SET PROGRAM DISCARD PROGRAM INQUIRE TRANSACTION SET TRANSACTION DISCARD TRANSACTION INQUIRE TERMINAL SET TERMINAL INQUIRE NETNAME SET NETNAME DISCARD TERMINAL INQUIRE TERMINAL SET TERMINAL INQUIRE NETNAME INQUIRE SYSTEM SET SYSTEM INQ SYSTEM SPOOLOPEN INPUT SPOOLOPEN OUTPUT SPOOLREAD SPOOLWRITE SPOOLCLOSE INQUIRE CONNECTION SET CONNECTION PERFORM ENDAFFINITY DISCARD CONNECTION INQUIRE MODENAME SET MODENAME INQUIRE TDQUEUE SET TDQUEUE Type SPI SPI SPI SPI API API API API SPI SPI SPI SPI SPI SPI SPI SPI SPI SPI SPI SPI SPI SPI SPI SPI SPI SPI SPI SPI API API API API API SPI SPI SPI SPI SPI SPI SPI SPI EIBFN value X'5C10' X'5E02' X'5E04' X'5E06' X'5E08' X'5E12' X'5E14' X'5E18' X'5E1A' X'5E1C' X'5E22' X'5E32' X'6002' X'6004' X'6010' X'6012' X'6014' X'6202' X'6204' X'6402' X'6602' X'6604' X'6612' X'6614' X'6622' X'6624' X'6802' X'6804' X'6812' X'6814' X'6822' X'6824' X'6826' X'6A02' X'6C02' X'6C12' Command DISCARD TDQUEUE INQUIRE TASK SET TASK CHANGE TASK INQUIRE STORAGE INQUIRE TCLASS SET TCLASS DISCARD TRANCLASS INQUIRE TRANCLASS SET TRANCLASS WAIT EXTERNAL WAITCICS INQUIRE JOURNALNUM SET JOURNALNUM DISCARD JOURNALNAME INQUIRE JOURNALNAME SET JOURNALNAME INQUIRE VOLUME SET VOLUME PERFORM SECURITY INQUIRE DUMPDS SET DUMPDS INQUIRE TRANDUMPCODE SET TRANDUMPCODE INQUIRE SYSDUMPCODE SET SYSDUMPCODE INQUIRE VTAM SET VTAM INQUIRE AUTOINSTALL SET AUTOINSTALL INQUIRE DELETSHIPPED SET DELETSHIPPED PERFORM DELETSHIPPED QUERY SECURITY WRITE OPERATOR CICSMESSAGE Type SPI SPI SPI API SPI SPI SPI SPI SPI SPI API API SPI SPI SPI SPI SPI SPI SPI SPI SPI SPI SPI SPI SPI SPI SPI SPI SPI SPI SPI SPI SPI API API API

246

CICS User’s Handbook

EIBFN codes
EIBFN value X'6E02' X'6E04' X'7002' X'7004' X'7006' X'7008' X'7012' X'7014' X'7202' X'7402' X'7404' X'7406' X'7408' X'7602' X'7802' X'7804' X'7812' X'7814' X'7822' X'7824' X'7A02' X'7A04' X'7C02' X'7E02' X'7E04' X'8002' X'8004' X'8012' X'8014' X'801A' X'8022' X'8030' X'820E' X'8210' X'8210' X'8212' Command INQUIRE IRC SET IRC INQUIRE STATISTICS SET STATISTICS PERFORM STATISTICS COLLECT STATISTICS INQUIRE MONITOR SET MONITOR PERFORM RESETTIME SIGNON SIGNOFF VERIFY PASSWORD CHANGE PASSWORD PERFORM SHUTDOWN INQUIRE TRACEDEST SET TRACEDEST INQUIRE TRACEFLAG SET TRACEFLAG INQUIRE TRACETYPE SET TRACETYPE INQUIRE DSNAME SET DSNAME INQ EXCI DUMP TRANSACTION PERFORM DUMP INQUIRE TSQUEUE SET TSQUEUE INQUIRE TSQNAME SET TSQNAME INQUIRE TSPOOL INQUIRE TSMODEL DISCARD TSMODEL AP ALLOCATE POOL ALLOCATE PASSCONVID CONVERSE FORMATTED Type SPI SPI SPI SPI SPI SPI SPI SPI SPI API API API API SPI SPI SPI SPI SPI SPI SPI SPI SPI SPI API SPI SPI SPI SPI SPI SPI SPI SPI FEPI FEPI FEPI FEPI EIBFN value Command Type FEPI FEPI FEPI FEPI FEPI FEPI FEPI FEPI FEPI FEPI FEPI FEPI FEPI FEPI FEPI FEPI FEPI FEPI FEPI FEPI FEPI FEPI FEPI FEPI FEPI FEPI FEPI FEPI FEPI FEPI FEPI FEPI FEPI FEPI SPI SPI SPI

X'8214' CONVERSE DATASTREAM X'8216' EXTRACT CONV X'8218' EXTRACT FIELD X'821A' EXTRACT STSN X'821C' FREE X'821E' ISSUE X'8220' RECEIVE FORMATTED X'8222' RECEIVE DATASTREAM X'8224' SEND FORMATTED X'8226' SEND DATASTREAM X'8228' START X'840E' SP X'8422' INQUIRE PROPERTYSET X'8428' INSTALL PROPERTYSET X'8430' DISCARD PROPERTYSET X'8442' INQUIRE NODE X'8444' SET NODE X'8444' SET NODELIST X'8448' INSTALL NODELIST X'844A' ADD POOL X'844C' DELETE POOL X'8450' DISCARD NODELIST X'8462' INQUIRE POOL X'8464' SET POOL X'8464' SET POOLLIST X'8468' INSTALL POOL X'8470' DISCARD POOL X'8482' INQUIRE TARGET X'8484' SET TARGETLIST X'8484' SET TARGET X'8488' INSTALL TARGETLIST X'8490' DISCARD TARGETLIST X'84A2' INQUIRE CONNECTION X'84A4' SET CONNECTION X'8602' ACQUIRE X'8802' INQUIRE EXITPROGRAM X'8A02' INQUIRE REQID

Chapter 8. EXEC interface block (EIB)

247

EIBFN codes
EIBFN value X'8C02' X'9002' X'9004' X'9022' X'9042' X'9044' X'9062' X'9082' X'9084' X'9090' X'9202' X'9210' X'9212' X'9402' X'9404' X'9410' X'9422' X'9424' X'9430' X'9442' X'9444' X'9450' X'9602' X'9604' X'9610' X'9612' X'9614' X'9616' X'9618' X'9620' X'9622' X'9624' X'9626' X'9628' X'962A' Command WRITE MESSAGE INQUIRE UOW SET UOW INQUIRE UOWENQ INQUIRE UOWLINK SET UOWLINK INQUIRE UOWDSNFAIL INQUIRE ENQMODEL SET ENQMODEL DISCARD ENQMODEL INQUIRE JOURNALMODEL DISCARD JOURNALMODEL INQUIRE STREAMNAME INQUIRE DB2CONN SET DB2CONN DISCARD DB2CONN INQUIRE DB2ENTRY SET DB2ENTRY DISCARD DB2ENTRY INQUIRE DB2TRAN SET DB2TRAN DISCARD DB2TRAN INQUIRE PROCESSTYPE SET PROCESSTYPE DISCARD PROCESSTYPE INQUIRE ACTID INQUIRE CONTAIN INQUIRE EVENT INQUIRE PROCESS STARTBROWSE ACTIVITY GETNEXT ACTIVITY ENDBROWSE ACTIVITY STARTBROWSE CONTAINER GETNEXT CONTAINER ENDBROWSE CONTAINER Type API SPI SPI SPI SPI SPI SPI SPI SPI SPI SPI SPI SPI SPI SPI SPI SPI SPI SPI SPI SPI SPI SPI SPI SPI SPI SPI SPI SPI SPI SPI SPI SPI SPI SPI EIBFN value Command Type SPI SPI SPI SPI SPI SPI SPI SPI SPI SPI SPI SPI SPI SPI SPI SPI SPI SPI SPI SPI SPI SPI

X'962C' STARTBROWSE EVENT X'962E' GETNEXT EVENT X'9630' ENDBROWSE EVENT X'9632' STARTBROWSE PROCESS X'9634' GETNEXT PROCESS X'9636' ENDBROWSE PROCESS X'9638' INQUIRE TIMER X'963A' STARTBROWSE TIMER X'963C' GETNEXT TIMER X'963E' ENDBROWSE TIMER X'9802' INQUIRE CFDTPOOL X'9A02' INQUIRE REQUESTMODEL X'9A10' DISCARD REQUESTMODEL X'9C02' INQUIRE TCPIPSERVICE X'9C04' SET TCPIPSERVICE X'9C10' DISCARD TCPIPSERVICE X'9C12' INQUIRE TCPIP X'9C14' SET TCPIP X'9C22' INQUIRE WEB X'9C24' SET WEB X'9E02' INQUIRE DOCTEMPLATE X'9E10' DISCARD DOCTEMPLATE

248

CICS User’s Handbook

EIBRCODE values

EIBRCODE values
See the notes at the end of the list of values for explanations of the numbers following some of the conditions.
EIBFN EIBFN 2 .. 4 4 4 4 4 4 4 4 4 4 4 4 4 4 4 4 4 4 4 4 4 4 4 4 4 4 6 6 6 6 6 6 6 6 6 6 6 6 6 .. .. .. .. .. .. .. .. .. .. .. .. .. .. .. .. .. .. .. .. .. .. .. .. .. .. .. .. .. .. .. .. .. .. .. .. .. .. .. EIBRCODE E 4 1 C1 C2 D D2 D3 D4 D5 E E1 E3 E4 E5 E6 E7 E8 EA EB EC ED F1 .. .. .. .. 1 2 3 5 8 C D F 8 81 82 83 84 Condition 6 6 6 6 6 6 8 8 8 8 8 8 8 8 8 8 8 8 A A A A A A A A A .. .. .. .. .. .. .. .. .. .. .. .. .. .. .. .. .. .. .. .. .. .. .. .. .. .. .. EIBRCODE 85 86 D D1 D6 E1 1 2 4 8 1 C D D1 D6 D7 E E1 1 2 4 8 .. .. .. .. .. .. .. .. .. .. .. .. .. .. .. .. .. .. .. .. .. .. .. .. .. .. .. .. .. .. .. .. .. .. .. .. .. .. .. .. .. .. .. .. .. .. .. .. .. .. .. .. .. .. .. .. .. .. .. .. .. .. .. .. .. .. .. .. .. .. .. .. .. .. .. .. .. .. .. .. .. .. .. .. .. .. .. .. .. .. .. .. .. .. .. .. .. .. .. .. .. .. .. .. .. .. .. .. .. .. .. .. .. .. .. .. .. .. .. .. .. .. .. .. .. .. Condition SUPPRESSED LOADING SYSIDERR3 ISCINVREQ NOTAUTH LENGERR QZERO QIDERR IOERR NOTOPEN NOSPACE QBUSY SYSIDERR3 ISCINVREQ NOTAUTH DISABLED INVREQ LENGERR ITEMERR QIDERR IOERR NOSPACE INVREQ SYSIDERR3 ISCINVREQ NOTAUTH LENGERR

.. .. .. .. .. INVREQ .. .. .. .. .. .. .. .. .. .. .. .. .. .. .. .. .. .. .. .. .. .. 2 4 .. .. .. .. .. .. .. .. .. .. .. .. .. .. .. .. .. .. .. .. .. .. .. .. .. .. .. .. .. .. .. .. .. .. .. .. .. .. .. .. .. .. .. .. .. .. .. .. .. .. .. .. .. .. .. .. .. .. .. .. .. .. .. .. .. .. .. .. .. .. .. .. .. .. .. .. .. .. F6 F7 .. .. .. .. .. .. .. .. .. .. .. .. .. .. .. .. .. .. .. .. .. .. .. .. .. .. .. .. .. .. .. .. .. .. .. .. .. .. .. .. .. .. .. .. .. .. .. .. .. .. .. .. .. .. .. .. .. .. .. .. .. .. .. .. .. .. .. .. .. .. .. .. .. .. .. .. .. .. .. .. .. .. .. .. .. .. .. .. .. .. .. EOF EODS EOF ENDINPT SYSIDERR3 SESSIONERR4 SYSBUSY5 SESSBUSY NOTALLOC INVREQ6 LENGERR7 WRBRK RDATT SIGNAL TERMIDERR NOPASSBKRD NOPASSBKWR IGREQCD CBIDERR PARTNERIDERR NETNAMEIDERR TERMERR EOC INBFMH NOSTART NONVAL FILENOTFOUND ILLOGIC1 LOCKED RECORDBUSY INVREQ NOTOPEN DISABLED ENDFILE IOERR1 NOTFND DUPREC NOSPACE DUPKEY

.. .. .. .. 2 .. D .. D1 .. D6 .. E1 ..

C .. C .. E E E E E .. .. .. .. ..

E1 .. .. .. .. .. LENGERR E2 .. .. .. .. .. NOSTG 1 D6 E E1 F1 .. .. .. .. .. .. .. .. .. .. .. .. .. .. .. .. .. .. .. .. .. .. .. .. .. PGMIDERR NOTAUTH INVREQ LENGERR TERMERR

Chapter 8. EXEC interface block (EIB)

249

EIBRCODE values

EIBFN 1 1 1 1 1 1 1 1 1 1 1 1 1 .. .. .. .. .. .. .. .. .. .. .. .. ..

EIBRCODE 1 4 11 12 2 81 D D1 D6 D8 E1 E9 FF .. .. .. .. .. .. .. .. .. .. .. .. .. .. .. .. .. .. .. .. .. .. .. .. .. .. .. .. .. .. .. .. .. .. .. .. .. .. .. .. .. .. .. .. .. .. .. .. .. .. .. .. .. .. .. .. .. .. .. .. .. .. .. .. ..

Condition ENDDATA IOERR TRANSIDERR TERMIDERR EXPIRED NOTFND SYSIDERR3 ISCINVREQ NOTAUTH USERIDERR LENGERR ENVDEFERR INVREQ

EIBFN 18 .. 1A 1A 1A 1A 1A 1A 1A 1A 1A .. .. .. .. .. .. .. .. ..

EIBRCODE .. .. 1 E

Condition .. .. .. IGREQID .. .. .. .. .. .. .. .. .. .. .. .. .. .. .. .. .. .. INVREQ DSSTAT FUNCERR SELNERR UNEXPIN LENGERR EODS IGREQCD EOC

.. .. .. 4 .. .. .. 8 .. .. .. C .. .. .. 1 .. .. .. E1 .. .. .. .. 11 .. .. .. 2B .. .. .. .. 2 .. 8

22 .. 4A .. 56 56 56 56 56 56 56 56 56 56 56 56 56 56 56 56 .. .. .. .. .. .. .. .. .. .. .. .. .. .. .. ..

.. .. .. .. .. INVEXITREQ 1 .. .. ERROR D 1 13 14 15 16 2A 46 5 55 56 57 58 59 5A 6 .. .. .. .. .. .. .. .. .. .. .. .. .. .. .. .. .. .. .. .. .. .. .. .. .. .. .. .. .. .. .. .. NOTFND INVREQ NOTOPEN ENDFILE ILLOGIC LENGERR NOSTG NOTAUTH NOSPOOL ALLOCERR STRELERR OPENERR SPOLBUSY SPOLERR NODEIDERR OUTDESCRERR

12 .. 12 .. 12 .. 14 14 14 14 14 14 14 .. .. .. .. .. .. ..

32 .. .. .. .. .. ENQBUSY E .. .. .. .. .. INVREQ E1 .. .. .. .. .. LENGERR 1 2 5 6 7 9 D6 .. .. .. .. .. .. .. .. .. .. .. .. .. .. .. .. .. .. .. .. .. .. .. .. .. .. .. .. .. .. .. .. .. .. .. JIDERR INVREQ NOTOPEN LENGERR IOERR NOJBUFSP NOTAUTH

.. .. .. .. .. .. .. .. .. .. .. .. .. .. .. .. .. .. .. .. .. .. .. .. .. .. .. .. .. .. .. .. .. .. .. .. .. .. .. .. .. .. .. .. .. .. .. .. .. .. ..

16 .. 18 18 18 18 18 18 18 18 18 18 18 18 18 18 18 18 18 18 18 18 .. .. .. .. .. .. .. .. .. .. .. .. .. .. .. .. .. .. .. ..

1 .. .. .. .. .. ROLLEDBACK 1 2 4 8 2 4 8 E1 E3 E4 .. .. .. .. .. .. .. .. .. .. .. .. .. .. .. .. .. .. .. .. 2 4 8 1 2 4 8 .. .. .. .. .. .. .. .. .. .. .. .. .. .. .. .. .. .. .. .. 1 4 8 .. .. .. .. .. .. .. .. .. .. .. .. .. .. .. .. .. .. .. .. .. .. .. .. .. .. .. .. .. .. .. .. .. .. .. .. .. .. .. .. .. .. .. .. .. .. .. .. .. .. .. .. .. .. .. .. .. .. .. .. INVREQ RETPAGE MAPFAIL INVMPSZ2 INVERRTERM RTESOME RTEFAIL LENGERR WRBRK RDATT PARTNFAIL INVPARTN INVPARTNSET INVLDC UNEXPIN IGREQCD TSIOERR OVERFLOW EODS EOC

250

CICS User’s Handbook

EIBRCODE values
Notes: 1. When ILLOGIC or IOERR occurs during file control operations, further information is provided in field EIBRCODE, as follows: .. .. .. .. .. xx xx .. .. .. xx .. xx .. .. xx .. .. xx .. xx .. .. .. xx .. .. .. .. .. BDAM response VSAM return code VSAM error code VSAM problem determination code 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 field EIBRCODE contains the terminal code: .. .. .. xx .. .. terminal code 3. When SYSIDERR occurs, further information is provided in bytes 1 and 2 of EIBRCODE, as follows: .. .. .. .. .. .. .. .. 4 4 4 4 4 4 4 8 .. .. .. request was for invalid function 4 .. .. .. no session available and NOQUEUE 8 .. .. .. mode name not found C .. .. .. mode name invalid 1 .. .. .. task canceled or timed out during allocation 14 .. .. .. mode group is out of service 18 .. .. .. close - DRAIN=ALL (Note: APPC only) .. .. .. .. SYSID out of service – for function shipping requests, the exit program (XISCONA) may have refused to queue the request because the intersystem connection is busy xx .. .. .. SYSID definition error .. .. .. name not that of TCTSE 4 .. .. .. name not that of remote TCTSE 8 .. .. .. mode name not found C .. .. .. profile not found

.. .. .. .. ..

C C C C C

Further information about SYSIDERR can be found in the CICS Intercommunication Guide. 4. When SESSIONERR occurs, further information is provided in bytes 1 and 2 of EIBRCODE, as follows: .. .. .. .. 8 .. .. .. .. C xx .. .. .. C .. .. .. C C .. .. .. session out of service session definition error name not found profile not found

Chapter 8. EXEC interface block (EIB)

251

EIBRCODE values
Further information about SESSIONERR can be found in the CICS Intercommunication Guide. 5. If SYSBUSY occurs on an ALLOCATE command that attempts to acquire a session to an APPC terminal or system, byte 3 of the EIBRCODE indicates where the error condition was detected: .. .. .. .. .. .. .. .. the request was for a session to a connected terminal or system 1 .. .. the request was for a session to a remotely connected terminal or system, and the error occurred in the terminal-owning region (TOR) or an intermediate system 2 .. .. the request was for a session to a remotely connected terminal or system, and the error occurred in the application-owning region (AOR)

.. .. ..

Further information about SYSBUSY can be found in the CICS Intercommunication Guide. 6. When INVREQ occurs during terminal control operations, further information 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 has been requested but cannot be supported on the session in use 1 .. .. EXTRACT ATTACH command - invalid data 14 .. .. SEND command - CONFIRM option has been specified but conversation is not SYNCLVL 1 18 .. .. EXTRACT TCT command - invalid netname 1C .. .. an invalid command has been issued for the terminal or logical unit in use 2 .. .. an invalid command has been issued for the LU6.2 conversation 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, further information is provided in byte 1 of EIBRCODE, as follows: .. .. .. .. .. .. input data is overlong and has been truncated 4 .. .. .. .. on output commands, an invalid (FROM)LENGTH has been specified, either less than zero or greater than 32767 .. 8 .. .. .. .. on input commands, an invalid (TO)LENGTH has been specified, greater than 32767 .. C .. .. .. .. length error has occurred on ISSUE PASS command

Chapter 8. EXEC interface block (EIB)

253

RESP values

RESP values and conditions
RESP value 00 01 02 03 04 05 06 07 08 09 10 11 12 13 14 15 16 17 18 19 20 21 22 23 24 25 26 27 28 29 30 31 32 33 34 35 36 37 38 39 40 41 42 43 44 Condition NORMAL ERROR RDATT WRBRK EOF EODS EOC INBFMH ENDINPT NONVAL NOSTART TERMIDERR FILENOTFOUND NOTFND DUPREC DUPKEY INVREQ IOERR NOSPACE NOTOPEN ENDFILE ILLOGIC LENGERR QZERO SIGNAL QBUSY ITEMERR PGMIDERR TRANSIDERR ENDDATA INVTSREQ EXPIRED RETPAGE RTEFAIL RTESOME TSIOERR MAPFAIL INVERRTERM INVMPSZ IGREQID OVERFLOW INVLDC NOSTG JIDERR QIDERR RESP value 45 46 47 48 49 50 51 52 53 54 55 56 57 58 59 60 61 62 63 64 65 66 67 68 69 70 71 72 73 74 75 76 77 78 79 80 81 82 83 84 85 86 87 88 89 Condition NOJBUFSP DSSTAT SELNERR FUNCERR UNEXPIN NOPASSBKRD NOPASSBKWR SYSIDERR ISCINVREQ ENQBUSY ENVDEFERR IGREQCD SESSIONERR SYSBUSY SESSBUSY NOTALLOC CBIDERR INVEXITREQ INVPARTNSET INVPARTN PARTNFAIL USERIDERR NOTAUTH VOLIDERR SUPPRESSED RESIDERR NOSPOOL TERMERR ROLLEDBACK END DISABLED ALLOCERR STRELERR OPENERR SPOLBUSY SPOLERR

254

CICS User’s Handbook

RESP values
RESP value 90 91 92 93 94 95 96 97 98 99 100 101 102 103 104 105 106 107 108 109 110 111 112 113 114 115 116 117 118 Condition NODEIDERR TASKIDERR TCIDERR DSNNOTFOUND LOADING MODELIDERR OUTDESCRERR PARTNERIDERR PROFILEIDERR NETNAMEIDERR LOCKED RECORDBUSY UOWNOTFOUND UOWLNOTFOUND LINKABEND CHANGED PROCESSBUSY ACTIVITYBUSY PROCESSERR ACTIVITYERR CONTAINERERR EVENTERR TOKENERR NOTFINISHED POOLERR TIMERERR SYMBOLERR TEMPLATERR -

Chapter 8. EXEC interface block (EIB)

255

RESP values

256

CICS User’s Handbook

RESP2 values

Chapter 9. RESP2 values and their meanings
Note: The RESP2 values returned by the CICS/ESA Front End Programming Interface are described in the CICS Front End Programming Interface User's Guide.
Command ACQUIRE TERMINAL Condition INVREQ RESP2 2 3 Meaning The terminal is a remote terminal The terminal is LU6.1, APPC, IRC or a non-VTAM device The terminal is not in service; that is, it is not available for use. VTAM is not open CICS is already in the process of acquiring this session. NOQUEUE and QNOTENAB options are invalid for a logged-on device Out-of-range value supplied in the USERDATALEN option The user associated with the task is not authorized to use this command The terminal cannot be found The TCTUA option is specified on an ADDRESS command issued in a DPL server program The task does not have a signed-on user No BMS command has yet been issued, BMS routing is in effect, or no map has yet been positioned No BDI command has yet been issued

4

5 7

8

LENGERR

6

NOTAUTH

100

TERMIDERR

1

ADDRESS

INVREQ

200

ASSIGN

INVREQ

1 2

3

© Copyright IBM Corp. 1989, 1999

257

RESP2 values
Command Condition RESP2 4 Meaning The task is not initiated by automatic transaction initiation (ATI) The task is not associated with a terminal; or the task has no principal facility; or the principal facility is not am MRO, LU6.1, or APPC session Command syntax options are not allowed in a server program invoked by a distributed program link There is an unknown return code in ESMRESP from the external security manager The CICS external security manager interface is not initialized The external security manager is not responding The supplied password is wrong The new password is not acceptable The USERID is revoked The change password request failed during SECLEVEL processing The user is revoked in the connection to the default group The USERID is not known to the external security manager

5

200

CHANGE PASSWORD

INVREQ

13

18

29

NOTAUTH

2 4 19 22

31

USERIDERR

8

CHANGE TASK

INVREQ

1

The PRIORITY value is outside the range 0–255

258

CICS User’s Handbook

RESP2 values
Command COLLECT STATISTICS Condition NOTFND RESP2 1 Meaning The requested resource cannot be found (for example, if the JOURNALNAME specified is not known to CICS) The type of resource is not defined in the CICS system The requested statistics area was not functioning The TCLASS value was not in the range 1–10, or the LSRPOOL value was not in the range 1–8 The user associated with the issuing task is not authorized to use this command The user associated with the task is not authorized to access this particular resource in the way required by this command A distributed program link server application specified the function-shipping session (its principal facility) on the CONVID option A distributed program link server application specified the function-shipping session (its principal facility) on the CONVID option The length specified in ATTRLEN is negative The command cannot be executed because an earlier connection or terminal pool definition has not yet been completed The user associated with the issuing task is not authorized to use this command

2

IOERR INVREQ

3 4

NOTAUTH

100

101

CONNECT PROCESS

INVREQ

200

CONVERSE

INVREQ

200

CREATE CONNECTION

LENGERR ILLOGIC

1 2

NOTAUTH

100

Chapter 9. RESP2 values and their meanings

259

RESP2 values
Command Condition RESP2 102 Meaning The user of the transaction issuing the CREATE CONNECTION is not an authorized surrogate of the userid specified in SECURITYNAME Syntax error in ATTRIBUTES string, or error occurred during either discard or resource definition phase of processing The command was executed in a program that has been linked to from a remote system that has not specified the SYNCONRETURN option, or has been linked to locally and is defined with EXECUTIONSET=DPLSUBSET The length specified in ATTRLEN is negative Command cannot be executed because an earlier CONNECTION or TERMINAL pool definition not yet completed There is a syntax error in the ATTRIBUTES string, or an error occurred during either the discard or resource definition phase of processing The command was executed in a program defined with an EXECUTIONSET value of DPLSUBSET or a program invoked from a remote system by a distributed program link without the SYNCONRETURN option.

INVREQ

n

200

CREATE DB2CONN

LENGERR ILLOGIC

1 2

INVREQ

n

200

260

CICS User’s Handbook

RESP2 values
Command Condition NOTAUTH RESP2 100 Meaning The user associated with the issuing task is not authorized to use this command The user associated with the issuing task is not an authorized surrogate of the user specified in AUTHID, COMAUTHID, or SIGNID parameter The user associated with the issuing task is not authorized to create a DB2CONN with an AUTHTYPE or COMAUTHTYPE parameter The length specified in ATTRLEN is negative Command cannot be executed because an earlier CONNECTION or TERMINAL pool definition not yet completed There is a syntax error in the ATTRIBUTES string, or an error occurred during either the discard or resource definition phase of processing The command was executed in a program defined with an EXECUTIONSET value of DPLSUBSET or a program invoked from a remote system by a distributed program link without the SYNCONRETURN option. The user associated with the issuing task is not authorized to use this command

102

103

CREATE DB2ENTRY

LENGERR ILLOGIC

1 2

INVREQ

n

200

NOTAUTH

100

Chapter 9. RESP2 values and their meanings

261

RESP2 values
Command Condition RESP2 101 Meaning The user associated with the issuing task is not authorized to create a DB2ENTRY definition with this name The user associated with the issuing task is not an authorized surrogate of the user specified in the AUTHID parameter The user associated with the issuing task is not authorized to create a DB2ENTRY with an AUTHTYPE parameter The length specified in ATTRLEN is negative Command cannot be executed because an earlier CONNECTION or TERMINAL pool definition not yet completed There is a syntax error in the ATTRIBUTES string, or an error occurred during either the discard or resource definition phase of processing The command was executed in a program defined with an EXECUTIONSET value of DPLSUBSET or a program invoked from a remote system by a distributed program link without the SYNCONRETURN option. The user associated with the issuing task is not authorized to use this command The user associated with the issuing task is not authorized to create a DB2TRAN definition and associate it with the named DB2ENTRY

102

103

CREATE DB2TRAN

LENGERR ILLOGIC

1 2

INVREQ

n

200

NOTAUTH

100

101

262

CICS User’s Handbook

RESP2 values
Command Condition RESP2 102 Meaning The user associated with the issuing task is not an authorized surrogate of the user specified in the AUTHID parameter of the DB2ENTRY named in the DB2TRAN The user associated with the issuing task is not authorized to create a DB2TRAN with the DB2ENTRY specifying AUTHTYPE The length specified in ATTRLEN is negative There is a syntax error in the ATTRIBUTES string, or an error occurred during either the discard or resource definition phase of processing The command was executed in a program defined with an EXECUTIONSET value of DPLSUBSET or a program invoked from a remote system by a distributed program link without the SYNCONRETURN option. The user associated with the issuing task is not authorized to use this command The length specified in ATTRLEN is negative There is a syntax error in the ATTRIBUTES string, or an error occurred during either the discard or resource definition phase of processing

103

CREATE DOCTEMPLATE

LENGERR INVREQ

1 n

200

NOTAUTH

100

CREATE ENQMODEL

LENGERR INVREQ

1 n

Chapter 9. RESP2 values and their meanings

263

RESP2 values
Command Condition RESP2 200 Meaning The command was executed in a program defined with an EXECUTIONSET value of DPLSUBSET or a program invoked from a remote system by a distributed program link without the SYNCONRETURN option. The user associated with the issuing task is not authorized to use this command The user associated with the issuing task is not authorized to create this a ENQMODEL definition with this name The length specified in ATTRLEN is negative The command cannot be executed because an earlier connection or terminal pool definition has not yet been completed The user associated with the issuing task is not authorized to use this command The user associated with the issuing task is not authorized to create a FILE definition with this name There is a syntax error in the ATTRIBUTES string, or an error occurred during either the discard or resource definition phase of processing

NOTAUTH

100

101

CREATE FILE

LENGERR ILLOGIC

1 2

NOTAUTH

100

101

INVREQ

n

264

CICS User’s Handbook

RESP2 values
Command Condition RESP2 200 Meaning The command was executed in a program that has been linked to from a remote system that has not specified the SYNCONRETURN option, or has been linked to locally and is defined with EXECUTIONSET=DPLSUBSET The length specified in ATTRLEN is negative The command cannot be executed because an earlier CONNECTION or TERMINAL pool definition has not yet been completed The user associated with the issuing task is not authorized to use this command There is a syntax error in the ATTRIBUTES string, or an error occurred during either the discard or resource definition phase of processing The command was executed in a program that has been linked to from a remote system that has not specified the SYNCONRETURN option, or has been linked to locally and is defined with EXECUTIONSET=DPLSUBSET The length specified in ATTRLEN is negative The command cannot be executed because an earlier CONNECTION or TERMINAL pool definition has not yet been completed The user associated with the issuing task is not authorized to use this command

CREATE JOURNALMODEL

LENGERR ILLOGIC

1 2

NOTAUTH

100

INVREQ

n

200

CREATE LSRPOOL

LENGERR ILLOGIC

1 2

NOTAUTH

100

Chapter 9. RESP2 values and their meanings

265

RESP2 values
Command Condition INVREQ RESP2 n Meaning There is a syntax error in the ATTRIBUTES string, or an error occurred during either the discard or resource definition phase of processing The command was executed in a program that has been linked to from a remote system that has not specified the SYNCONRETURN option, or has been linked to locally and is defined with EXECUTIONSET=DPLSUBSET The length specified in ATTRLEN is negative The command cannot be executed because an earlier CONNECTION or TERMINAL pool definition has not yet been completed The user associated with the issuing task is not authorized to use this command The user associated with the issuing task is not authorized to create a MAPSET definition with this name There is a syntax error in the ATTRIBUTES string, or an error occurred during either the discard or resource definition phase of processing The command was executed in a program that has been linked to from a remote system that has not specified the SYNCONRETURN option, or has been linked to locally and is defined with EXECUTIONSET=DPLSUBSET

200

CREATE MAPSET

LENGERR ILLOGIC

1 2

NOTAUTH

100

101

INVREQ

n

200

266

CICS User’s Handbook

RESP2 values
Command CREATE PARTITIONSET Condition LENGERR ILLOGIC RESP2 1 2 Meaning The length specified in ATTRLEN is negative The command cannot be executed because an earlier CONNECTION or TERMINAL pool definition has not yet been completed The user associated with the issuing task is not authorized to use this command The user associated with the issuing task is not authorized to create this particular PARTITIONSET There is a syntax error in the ATTRIBUTES string, or an error occurred during either the discard or resource definition phase of processing The command was executed in a program that has been linked to from a remote system that has not specified the SYNCONRETURN option, or has been linked to locally and is defined with EXECUTIONSET=DPLSUBSET The length specified in ATTRLEN is negative The command cannot be executed because an earlier CONNECTION or TERMINAL pool definition has not yet been completed The user associated with the issuing task is not authorized to use this command

NOTAUTH

100

101

INVREQ

n

200

CREATE PARTNER

LENGERR ILLOGIC

1 2

NOTAUTH

100

Chapter 9. RESP2 values and their meanings

267

RESP2 values
Command Condition INVREQ RESP2 n Meaning There is a syntax error in the ATTRIBUTES string, or an error occurred during either the discard or resource definition phase of processing The command was executed in a program that has been linked to from a remote system that has not specified the SYNCONRETURN option, or has been linked to locally and is defined with EXECUTIONSET=DPLSUBSET The length specified in ATTRLEN is negative The command cannot be executed because an earlier CONNECTION or TERMINAL pool definition has not yet been completed The user associated with the issuing task is not authorized to use this command There is a syntax error in the ATTRIBUTES string, or an error occurred during either the discard or resource definition phase of processing The command was executed in a program that has been linked to from a remote system that has not specified the SYNCONRETURN option, or has been linked to locally and is defined with EXECUTIONSET=DPLSUBSET The length specified in ATTRLEN is negative

200

CREATE PROFILE

LENGERR ILLOGIC

1 2

NOTAUTH

100

INVREQ

n

200

CREATE PROGRAM

LENGERR

1

268

CICS User’s Handbook

RESP2 values
Command Condition ILLOGIC RESP2 2 Meaning The command cannot be executed because an earlier CONNECTION or TERMINAL pool definition has not yet been completed The user associated with the issuing task is not authorized to use this command The user associated with the issuing task is not authorized to create this particular PROGRAM There is a syntax error in the ATTRIBUTES string, or an error occurred during either the discard or resource definition phase of processing The command was executed in a program that has been linked to from a remote system that has not specified the SYNCONRETURN option, or has been linked to locally and is defined with EXECUTIONSET=DPLSUBSET The length specified in ATTRLEN is negative The command cannot be executed because an earlier CONNECTION or TERMINAL pool definition has not yet been completed The user associated with the issuing task is not authorized to use this command There is a syntax error in the ATTRIBUTES string, or an error occurred during either the discard or resource definition phase of processing

NOTAUTH

100

101

INVREQ

n

200

CREATE REQUESTMODEL

LENGERR ILLOGIC

1 2

NOTAUTH

100

INVREQ

n

Chapter 9. RESP2 values and their meanings

269

RESP2 values
Command Condition RESP2 200 Meaning The command was executed in a program that has been linked to from a remote system that has not specified the SYNCONRETURN option, or has been linked to locally and is defined with EXECUTIONSET=DPLSUBSET The length specified in ATTRLEN is negative The command cannot be executed because an earlier CONNECTION or TERMINAL pool definition has not yet been completed The user associated with the issuing task is not authorized to use this command The user of transaction issuing CREATE SESSIONS is not an authorized surrogate of the user specified in USERID The user of the transaction issuing the CREATE SESSIONS command is not an authorized surrogate of the userid specified in USERID The command was executed in a program that has been linked to from a remote system that has not specified the SYNCONRETURN option, or has been linked to locally and is defined with EXECUTIONSET=DPLSUBSET

CREATE SESSIONS

LENGERR ILLOGIC

1 2

NOTAUTH

100

102

102

INVREQ

200

270

CICS User’s Handbook

RESP2 values
Command CREATE TCPIPSERVICE Condition INVREQ RESP2 n Meaning Syntax error in ATTRIBUTE string or an error occurred during either the discard or resource definition phase of processing The command executed in program defined with an EXECUTIONSET or DPLSUBSET, or a program invoked from a remote system by a distributed program link without the SYNCONRETURN option. Length specified in ATTRLEN is negative The user associated with the issuing task is not authorized to use this command The length specified in ATTRLEN is negative The command cannot be executed because an earlier CONNECTION or TERMINAL pool definition has not yet been completed The user associated with the issuing task is not authorized to use this command The user associated with the issuing task is not authorized to create a TDQUEUE definition with this name The user of the transaction issuing the CREATE TDQUEUE command is not an authorized surrogate of the user specified in USERID

200

LENGERR NOTAUTH

1 100

CREATE TDQUEUE

LENGERR ILLOGIC

1 2

NOTAUTH

100

101

102

Chapter 9. RESP2 values and their meanings

271

RESP2 values
Command Condition INVREQ RESP2 n Meaning There is a syntax error in the ATTRIBUTES string, or an error occurred during either the discard or resource definition phase of processing The command was executed in a program that has been linked to from a remote system that has not specified the SYNCONRETURN option, or has been linked to locally and is defined with EXECUTIONSET=DPLSUBSET The length specified in ATTRLEN is negative The command cannot be executed because an earlier CONNECTION or TERMINAL pool definition has not yet been completed The user associated with the issuing task is not authorized to use this command The user of the transaction issuing the CREATE TERMINAL command is not an authorized surrogate of the userid specified in USERID There is a syntax error in the ATTRIBUTES string, or an error occurred during either the discard or resource definition phase of processing

200

CREATE TERMINAL

LENGERR ILLOGIC

1 2

NOTAUTH

100

102

INVREQ

n

272

CICS User’s Handbook

RESP2 values
Command Condition RESP2 200 Meaning The command was executed in a program that has been linked to from a remote system that has not specified the SYNCONRETURN option, or has been linked to locally and is defined with EXECUTIONSET=DPLSUBSET The length specified in ATTRLEN is negative The command cannot be executed because an earlier CONNECTION or TERMINAL pool definition has not yet been completed The user associated with the issuing task is not authorized to use this command There is a syntax error in the ATTRIBUTES string, or an error occurred during either the discard or resource definition phase of processing The command was executed in a program that has been linked to from a remote system that has not specified the SYNCONRETURN option, or has been linked to locally and is defined with EXECUTIONSET=DPLSUBSET The length specified in ATTRLEN is negative The command cannot be executed because an earlier CONNECTION or TERMINAL pool definition has not yet been completed The user associated with the issuing task is not authorized to use this command

CREATE TRANCLASS

LENGERR ILLOGIC

1 2

NOTAUTH

100

INVREQ

n

200

CREATE TRANSACTION

LENGERR ILLOGIC

1 2

NOTAUTH

100

Chapter 9. RESP2 values and their meanings

273

RESP2 values
Command Condition RESP2 101 Meaning The user associated with the issuing task is not authorized to create this particular TRANSACTION There is a syntax error in the ATTRIBUTES string, or an error occurred during either the discard or resource definition phase of processing The command was executed in a program that has been linked to from a remote system that has not specified the SYNCONRETURN option, or has been linked to locally and is defined with EXECUTIONSET=DPLSUBSET The length specified in ATTRLEN is negative The user associated with the issuing task is not authorized to use this command The user associated with the issuing task is not authorized to create a TSMODEL definition with this name There is a syntax error in the ATTRIBUTES string, or an error occurred during either the discard or resource definition phase of processing The command was executed in a program that has been linked to from a remote system that has not specified the SYNCONRETURN option, or has been linked to locally and is defined with EXECUTIONSET=DPLSUBSET The length specified in ATTRLEN is negative

INVREQ

n

200

CREATE TSMODEL

LENGERR NOTAUTH

1 100

101

INVREQ

n

200

CREATE TYPETERM

LENGERR

1

274

CICS User’s Handbook

RESP2 values
Command Condition ILLOGIC RESP2 2 Meaning The command cannot be executed because an earlier CONNECTION or TERMINAL pool definition has not yet been completed The user associated with the issuing task is not authorized to use this command There is a syntax error in the ATTRIBUTES string, or an error occurred during either the discard or resource definition phase of processing The command was executed in a program that has been linked to from a remote system that has not specified the SYNCONRETURN option, or has been linked to locally and is defined with EXECUTIONSET=DPLSUBSET Hours are out of range Minutes are out of range Seconds are out of range The file name referred to in the FILE option cannot be found in the FCT Delete operations are not allowed according to the file entry specification in the FCT or the user-maintained data table was defined as a CICS file and the definition does not allow for delete operations A DELETE command was issued for a file referring to a VSAM ESDS A generic delete was issued for a file that is not a VSAM KSDS

NOTAUTH

100

INVREQ

n

200

DELAY

INVREQ

4 5 6 1

DELETE

FILENOTFOUND

INVREQ

20

21

22

Chapter 9. RESP2 values and their meanings

275

RESP2 values
Command Condition RESP2 25 Meaning The KEYLENGTH and GENERIC options were specified, and the length specified in the KEYLENGTH option is greater than or equal to the length of a full key The KEYLENGTH option was specified (but the GENERIC option is not specified), and the specified length does not equal the length defined for the data set to which this file refers A DELETE command was issued for a file referring to a BDAM data set A DELETE command without the RIDFLD option was issued for a file for which no previous READ UPDATE command has been issued The KEYLENGTH and GENERIC options were specified, and the length specified in the KEYLENGTH option is less than zero The DELETE command does not conform to the format of DELETE for a user-maintained table; for example if GENERIC were specified A DELETE instruction included a token whose value cannot be matched against any token in use for an existing READ for UPDATE request

26

27

31

42

44

47

276

CICS User’s Handbook

RESP2 values
Command Condition RESP2 51 Meaning A DELETE command specifying the RBA keyword was issued against a KSDS file that is being accessed in RLS mode. RLS does not support relative byte address (RBA) access to KSDS files NOSUSPEND was specified for a non-RLS file A file is disabled The requested file is CLOSED and UNENABLED or the requested file is OPEN and in use by other transactions, but a close request against it has been received or a DELETE command has been issued against a data set that is quiesced, or is being quiesced, as a result of a SET DSNAME QUIESCED or IMMQUIESCED commend The remote system indicated a failure that does not correspond to a known condition An attempt to delete a record based on the search argument provided is unsuccessful or, for user-maintained data tables, an attempt to delete a record was unsuccessful because there is no entry with the specified key in the data table A resource security check has failed on FILE(filename)

55

DISABLED NOTOPEN

50 60

ISCINVREQ

70

NOTFND

80

NOTAUTH

101

Chapter 9. RESP2 values and their meanings

277

RESP2 values
Command Condition LOADING RESP2 104 Meaning A delete request has been issued for a user-maintained table that is currently being loaded An attempt has been made to delete a record specifying the RIDFLD, but a retained lock exists against this key. If the request specified the GENERIC keyword, all possible records are deleted, but the locked records remain. The number of records deleted is returned by NUMREC The NOSUSPEND keyword was specified for the deletion of a record that is locked by a VSAM active lock A VSAM error has occurred which does not fall within the one of the other CICS response categories There has been an I/O error during the file control operation The SYSID option specified a name that is neither the local nor the remote system (made known to CICS by defining a CONNECTION); or the link to the remote system was closed. A record has been accessed by way of an alternate index with the NONUNIQUEKEY attribute, and another alternate index record with the same key follows

LOCKED

106

RECORDBUSY

107

ILLOGIC

110

IOERR

120

SYSIDERR

130

DUPKEY

140

278

CICS User’s Handbook

RESP2 values
Command DEQ Condition LENGERR RESP2 1 Meaning The value specified for the LENGTH option is outside the range 1–255 The MAXLIFETIME option has an incorrect CVDA

INVREQ

2

DISABLE PROGRAM

NOTAUTH

100

101

The user associated with the issuing task is not authorized to use this command The user associated with the issuing task is not authorized to access this particular resource in the way required by this command. The model cannot be found The model you requested is currently in use The model cannot be discarded because its name begins with DFH The user associated with the issuing task is not authorized to use this command The named connection cannot be found Remote and in-use Not set out-of-service and not remote Recovery work pending Discard processing failed Indirect connections point to this connection MRO connection and IRC active Delete already in flight Entry locked by another RDO action DPL subset without SYNCONRETURN The user of this command is not authorized

DISCARD AUTINSTMODEL

MODELIDERR INVREQ

1 2 3

NOTAUTH

100

DISCARD CONNECTION

SYSIDERR INVREQ

9 24 25 26 27 28 29 38 39 200

NOTAUTH

100

Chapter 9. RESP2 values and their meanings

279

RESP2 values
Command DISCARD DB2CONN Condition INVREQ NOTFND NOTAUTH RESP2 2 1 100 Meaning The CICS DB2 interface is active A DB2CONN cannot be found The user associated with the issuing task is not authorized to use this command The DB2ENTRY is currently in use The DB2ENTRY is not disabled The DB2ENTRY cannot be found The user associated with the issuing task is not authorized to use this command The user associated with the issuing task is not authorized to access this particular resource in the way required by this command The DB2ENTRY cannot be found The user associated with the issuing task is not authorized to use this command The user associated with the issuing task is not authorized to access the DB2ENTRY referenced by this DB2TRAN in the way required by this command The length specified in ATTRLEN is negative The user associated with the issuing task is not authorized to use this command

DISCARD DB2ENTRY

INVREQ

2 3

NOTFND NOTAUTH

1 100

101

DISCARD DB2TRAN

NOTFND NOTAUTH

1 100

101

DISCARD DOCTEMPLATE

LENGERR NOTAUTH

1 100

280

CICS User’s Handbook

RESP2 values
Command Condition INVREQ RESP2 n Meaning There is a syntax error in the ATTRIBUTES string, or an error occurred during either the discard or resource definition phase of processing The command was executed in a program that has been linked to from a remote system that has not specified the SYNCONRETURN option, or has been linked to locally and is defined with EXECUTIONSET=DPLSUBSET The specified ENQMODEL is not installed on this system The user associated with the issuing task is not authorized to use this command The file is not closed The file is not disabled The file definition is currently in use The file cannot be discarded because its name begins with DFH The file cannot be discarded because it has work outstanding for which there are retained locks The file cannot be found The user associated with the issuing task is not authorized to use this command The user associated with the issuing task is not authorized to access this particular resource in the way required by this command The specified JOURNALMODEL name was not found

200

DISCARD ENQMODEL

NOTFND

1

NOTAUTH

100

DISCARD FILE

INVREQ

2 3 25 26

43

FILENOTFOUND NOTAUTH

18 100

101

DISCARD JOURNALMODEL

NOTFND

1

Chapter 9. RESP2 values and their meanings

281

RESP2 values
Command Condition NOTAUTH DISCARD JOURNALNAME INVREQ RESP2 100 3 Meaning The user is not authorized for this command The specified journal name (for example, the system log) cannot be discarded The journal cannot be found The user is not authorized for this command The user does not have the required access authority to the specified journal name The partner cannot be found The Partner Resource Manager (PRM) is not active, because it failed to initialize during CICS initialization The partner definition is currently in use The partner cannot be discarded because its name begins with DFH The user associated with the issuing task is not authorized to use this command The profile cannot be found The profile definition is currently in use A transaction definition points to the profile The profile cannot be discarded because its name begins with DFH The user associated with the issuing task is not authorized to use this command

JIDERR NOTAUTH

1 100 101

DISCARD PARTNER

PARTNERIDERR

1 5

INVREQ

2 3

NOTAUTH

100

DISCARD PROFILE

PROFILEIDERR INVREQ

1 2 3 4

NOTAUTH

100

282

CICS User’s Handbook

RESP2 values
Command DISCARD PROGRAM Condition INVREQ RESP2 1 Meaning The resource cannot be discarded because its name begins with DFH The resource definition is currently in use The resource cannot be discarded because it is a user-replaceable module The resource definition cannot be found The user associated with the issuing task is not authorized to use this command The user associated with the issuing task is not authorized to access this particular resource in the way required by this command The requested model name was not found The user associated with the issuing task is not authorized to use this command The TCPIPservice is still open The TCPIPSERVICE name was not found The user associated with the issuing task is not authorized to use this command The queue cannot be found The queue name begins with the letter C The queue is not closed Disable pending The queue is not disabled

11 15

PGMIDERR NOTAUTH

7 100

101

DISCARD REQUESTMODEL

NOTFND NOTAUTH

1 100

DISCARD TCPIPSERVICE

INVREQ NOTFND NOTAUTH

9 3 100

DISCARD TDQUEUE

QIDERR INVREQ

1 11 18 30 31

Chapter 9. RESP2 values and their meanings

283

RESP2 values
Command Condition RESP2 200 Meaning The command was executed in a program that has been linked to from a remote system that has not specified the SYNCONRETURN option, or has been linked to locally and is defined with EXECUTIONSET=DPLSUBSET The user associated with the issuing task is not authorized to use this command The user associated with the issuing task is not authorized to access this particular resource in the way required by this command Named terminal cannot be found APPC session or device Terminal type not VTAM or console Not out of service and not remote Error console MRO session Delete failed Remote and in-use Locked by another RDO action Delete already in flight The command was executed in a program that has been linked to from a remote system that has not specified the SYNCONRETURN option, or has been linked to locally and is defined with EXECUTIONSET=DPLSUBSET The use of this command is not authorized The transaction class cannot be found

NOTAUTH

100

101

DISCARD TERMINAL

TERMIDERR INVREQ

23 33 38 39 40 41 43 44 45 46 200

NOTAUTH

100

DISCARD TRANCLASS

TCIDERR

1

284

CICS User’s Handbook

RESP2 values
Command Condition INVREQ RESP2 2 12 Meaning The TRANCLASS definition is in use The transaction class cannot be discarded because installed transactions belong to it The user associated with the issuing task is not authorized to use this command The transaction cannot be found The transaction cannot be discarded because its name begins with C The transaction is a SIT parameter The transaction is scheduled to run at a future time (in use by an interval control element) The transaction is scheduled to run when required resources are available (in use by an automatic initiate descriptor) The user associated with the issuing task is not authorized to use this command The user associated with the issuing task is not authorized to access this particular resource in the way required by this command The TSMODEL does not exist The TSMODEL definition is currentl in use The TS model cannot be discarded because its name begins with DFH

NOTAUTH

100

DISCARD TRANSACTION

TRANSIDERR INVREQ

1 4

13 14

15

NOTAUTH

100

101

DISCARD TSMODEL

NOTFND INVREQ

1 2 3

Chapter 9. RESP2 values and their meanings

285

RESP2 values
Command Condition NOTAUTH RESP2 100 Meaning The user associated with the issuing task is not authorized to use this command The user associated with the issuing task is not authorized to discard a TSMODEL with this name The transaction dump is suppressed by MAXIMUM in table The transaction dump is suppressed by NOTRANDUMP in table The transaction dump is suppressed by a user exit program The transaction dump is incomplete due to lack of space CICS has run out of working storage The current CICS dump routine is not open Error on opening, closing, or writing to, the current CICS dump routine The SDUMP process was not authorized An error occurred during system dumping The CICS routine issuing the SDUMP was unable to establish a recovery routine (FESTAE) An incorrect DUMPCODE was specified. DUMPCODE must not contain leading or imbedded blanks The user associated with the issuing task is not authorized to issue this command

101

DUMP TRANSACTION

SUPPRESSED

1

2

3

NOSPACE

4

NOSTG NOTOPEN OPENERR

5 6 7

IOERR

9 10 13

INVREQ

13

ENABLE PROGRAM

NOTAUTH

100

286

CICS User’s Handbook

RESP2 values
Command Condition RESP2 101 Meaning The user associated with the task is not authorized to access this particular resource in the way required by this command. The name referred to in the FILE option cannot be found in the FCT The REQID, if any, does not match that of any successful STARTBR command The remote system indicated a failure that does not correspond to a known condition A resource security check has failed on FILE(filename) A VSAM error which does not fall within one of the other CICS response categories has occurred. There has been an I/O error during the operation The SYSID option specified a name that is neither the local nor the remote system (made known to CICS by defining a connection); or the link to the remote system is closed. The value specified for the LENGTH option is outside the range 1–255 The MAXLIFETIME option has an incorrect CVDA TRACENUM is outside the range 0–199 There is no valid trace destination

ENDBR

FILENOTFOUND

1

INVREQ

35

ISCINVREQ

70

NOTAUTH

101

ILLOGIC

110

IOERR SYSIDERR

120 130

ENQ

LENGERR

1

INVREQ

2

ENTER TRACENUM

INVREQ

1 2

Chapter 9. RESP2 values and their meanings

287

RESP2 values
Command Condition RESP2 3 Meaning The user trace master flag is set OFF and EXCEPTION has not been specified FROMLENGTH is outside the range 0–4000 specified A distributed program link server application explicitly, or implicitly by default, specified the function-shipping session (its principal facility) on the CONVID option A distributed program link server application explicitly, or implicitly by default, specified the function-shipping session (its principal facility) on the CONVID option The user associated with the issuing task is not authorized to issue this command The user associated with the task is not authorized to access this particular resource in the way required by this command. A distributed program link server application specified the function-shipping session (its principal facility) on the CONVID option The ABSTIME option is in an incorrect format

LENGERR

4

EXTRACT ATTRIBUTES (APPC)

INVREQ

200

EXTRACT ATTRIBUTES (MRO)

INVREQ

200

EXTRACT EXIT

NOTAUTH

100

101

EXTRACT PROCESS

INVREQ

200

FORMATTIME

INVREQ

1

288

CICS User’s Handbook

RESP2 values
Command FREE (APPC) Condition INVREQ RESP2 200 Meaning A distributed program link server application specified the function-shipping session (its principal facility) on the CONVID option The storage specified by the DATA or DATAPOINTER parameter was not storage acquired by a GETMAIN command The storage area specified by the DATA or DATAPOINTER parameter was in CICS-key storage, and the program issuing the FREEMAIN command was in user-key. The FLENGTH value was less than 1 or greater than the length of the target storage area from which the request was to be satisfied The storage requested was more than was currently available in the target DSA The program has no entry in the PPT and autoinstall for programs is not active The program is disabled The installed program definition is for a remote program The command was issued by a distributed program link server application

FREEMAIN

INVREQ

1

2

GETMAIN

LENGERR

1

NOSTG

2

HANDLE ABEND

PGMIDERR

1

2 9

HANDLE AID

INVREQ

200

Chapter 9. RESP2 values and their meanings

289

RESP2 values
Command INQUIRE AUTINSTMODEL Condition ILLOGIC RESP2 1 Meaning A START has been given when a browse is already in progress, or a NEXT or an END has been given when a browse of this resource type is not in progress The model specified cannot be found There are no more resource definitions of this type The user associated with the issuing task is not authorized to use this command The console has an invalid CVDA value The user associated with the issuing task is not authorized to use this command There are no more coupling facility data table pools to browse START command issued when CFDTPOOLs already in progress, or NEXT or END issued when CFDTPOOLs is not in progress Named CFDTPOOL was not found An internal control structure that CICS uses to maintain access to CFDT pools has been altered while the set of pools known to CICS was being browsed. The user associated with the issuing task is not authorized to use this command

MODELIDERR END

1 2

NOTAUTH

100

INQUIRE AUTOINSTALL

INVREQ NOTAUTH

20 100

INQUIRE CFDTPOOL

END

2

ILLOGIC

1

POOLERR

1 2

NOTAUTH

100

290

CICS User’s Handbook

RESP2 values
Command INQUIRE CONNECTION Condition END RESP2 2 Meaning There are no more resource definitions of this type A START has been given when a browse is already in progress or a NEXT or an END has been given when a browse of this resource type is not in progress The user associated with the issuing task is not authorized to use this command The named connection could not be found The requested DB2CONN cannot be found Command authorization failure The requested DB2ENTRY cannot be found Command authorization failure Resource authorization failure The requested DB2TRAN cannot be found Command authorization failure Resource authorization failure The user associated with the issuing task is not authorized to use this command There are no more resource definitions of this type A START has been given when a browse is already in progress or a NEXT or an END has been given when a browse of this resource type is not in progress

ILLOGIC

1

NOTAUTH

100

SYSIDERR INQUIRE DB2CONN NOTFND NOTAUTH INQUIRE DB2ENTRY NOTFND

1 1 100 1

NOTAUTH

100 101

INQUIRE DB2TRAN

NOTFND NOTAUTH

1 100 101

INQUIRE DELETSHIPPED

NOTAUTH

100

INQUIRE DOCTEMPLATE

END

2

ILLOGIC

1

Chapter 9. RESP2 values and their meanings

291

RESP2 values
Command Condition MODELIDERR NOTAUTH RESP2 1 100 Meaning The DOCTEMPLATE specified cannot be found The user associated with the issuing task is not authorized to use this command The data set cannot be found There are no more resource definitions of this type A START has been given when a browse is already in progress or a NEXT or an END has been given when a browse of this resource type is not in progress QUIESCESTATE was specified, but an error was raised by DFSMS reading the ICF catalog An error was raised by DFSMS reading the ICF catalog to establish the base data set name The user associated with the issuing task is not authorized to use this command The user associated with the issuing task is not authorized to use this command There are no more resource definitions of this type The ENQMODEL cannot be found

INQUIRE DSNAME

DSNNOTFOUND END

1 2

ILLOGIC

1

IOERR

40

49

NOTAUTH

100

INQUIRE DUMPDS

NOTAUTH

100

INQUIRE ENQMODEL

END

2

NOTFND

1

292

CICS User’s Handbook

RESP2 values
Command Condition ILLOGIC RESP2 1 Meaning A START has been issued when a browse of this resoutrce type is already in progress, or a NEXT ot END issued when a browse of this resource type is not in progress The user associated with the issuing task is not authorized to use this command The user associated with the issuing task is not authorized to access this particular resource in the way required by this command There are no more resource definitions of this type A START has been issued when a browse of this resoutrce type is already in progress, or a NEXT ot END issued when a browse of this resource type is not in progress The user associated with the issuing task is not authorized to use this command The user associated with the issuing task is not authorized to access this particular resource in the way required by this command There are no more resource definitions of this type The exit point identified by EXIT does not exist

NOTAUTH

100

101

INQUIRE EXCI

END

2

ILLOGIC

1

NOTAUTH

100

101

INQUIRE EXITPROGRAM

END

2

INVREQ

3

Chapter 9. RESP2 values and their meanings

293

RESP2 values
Command Condition ILLOGIC RESP2 1 Meaning A START has been given when a browse is already in progress, or a NEXT or an END has been given when a browse of this resource type is not in progress The user associated with the issuing task is not authorized to use this command The user associated with the issuing task is not authorized to access this particular resource in the way required by this command The exit identified by EXITPROGRAM and ENTRYNAME is not enabled, or The EXIT parameter is missing for an inquiry on a global user exit, or The EXIT parameter is present on a task-related user exit There are no more resource definitions as this type The file cannot be found A START has been given when a browse is already in progress or a NEXT or an END has been given when a browse of this resource type is not in progress The user associated with the issuing task is not authorized to use this command

NOTAUTH

100

101

PGMIDERR

1

INQUIRE FILE

END

2

FILENOTFOUND ILLOGIC

1 1

NOTAUTH

100

294

CICS User’s Handbook

RESP2 values
Command Condition RESP2 101 Meaning The user associated with the issuing task is not authorized to access this particular resource in the way required by this command The user associated with the issuing task is not authorized to use this command All authorized resource definitions have been retrieved. All data areas specified on this command are left unchanged A START has been given when a browse is already in progress or a NEXT or an END has been given without a preceding START The browse token is not valid The specified journal model was not found The user is not authorized for this command All authorized resource definitions have been retrieved. All data areas specified on this command are left unchanged A START has been given when a browse is already in progress or a NEXT or an END has been given without a preceding START The browse token is not valid The specified journal name was not found

INQUIRE IRC

NOTAUTH

100

INQUIRE JOURNALMODEL

END

2

ILLOGIC

1

2 NOTFND NOTAUTH 1 100

INQUIRE JOURNALNAME

END

2

ILLOGIC

1

2 JIDERR 1

Chapter 9. RESP2 values and their meanings

295

RESP2 values
Command Condition NOTAUTH RESP2 100 101 Meaning The user is not authorized for this command The user does not have the required access authority to the specified resource (Not applicable to INQUIRE JOURNALNAME START, INQUIRE JOURNALNAME NEXT, or INQUIRE JOURNALNAME END commands)

INQUIRE MODENAME

END

2

ILLOGIC

1

SYSIDERR

1 2

3

NOTAUTH

100

INQUIRE MONITOR

NOTAUTH

100

There are no more resource difinitions of this type A START has been given when a browse is already in progress, or a NEXT or END has been given when a browse of this resource type is not in progress The connection cannot be found The modename within the connection cannot be found The connection specified on an INQUIRE MODENAME NEXT cannot be found The user associated with the issuing task is not authorized to use this command The user associated with the issuing task is not authorized to use this command There are no more resource definitions of this type

INQUIRE PARTNER

END

2

296

CICS User’s Handbook

RESP2 values
Command Condition ILLOGIC RESP2 1 Meaning A START has been given when a browse is already in progress or a NEXT or an END has been given when a browse if this resource type is not in progress The partner cannot be found Partner Resource Manager (PRM) is not active, because it failed to initialize during CICS initialization The user associated with the issuing task is not authorized to use this command There are no more resource definitions of this type A START has been given when a browse is already in progress, or a NEXT or an END has been given when a browse of this resource type is not in progress The profile cannot be found The user associated with the issuing task is not authorized to use this command There are no more resource definitions of this type A START has been given when a browse is already in progress or or a NEXT or an END has been given when a browse of this resource type is not in progress The program cannot be found

PARTNERIDERR

1 2

NOTAUTH

100

INQUIRE PROFILE

END

2

ILLOGIC

1

PROFILEIDERR NOTAUTH

1 100

INQUIRE PROGRAM

END

2

ILLOGIC

1

PGMIDERR

1

Chapter 9. RESP2 values and their meanings

297

RESP2 values
Command Condition NOTAUTH RESP2 100 Meaning The user associated with the issuing task is not authorized to use this command The user associated with the issuing task is not authorized to access this particular resource in the way required by this command The REQID cannot be found You have issued a START command when a browse is already in progress, or a NEXT or an END issued when a browse of this resource type is not in progress There are no more resource definitions of this type An I/O error occurred while an attempt was made to read data from temporary storage for the SET, QUEUE, RTERMID or RTRANSID option Data required for the SET, QUEUE, RTERMID or RTRANSID option cannot be returned because it has been deleted from temporary storage The user associated with the issuing task is not authorized to use this command The specified erquest model was not found

101

INQUIRE REQID

NOTFND ILLOGIC

1 1

END

2

INVREQ

3

4

NOTAUTH

100

INQUIRE REQUESTMODEL

NOTFND

1

298

CICS User’s Handbook

RESP2 values
Command Condition ILLOGIC RESP2 1 Meaning You have issued a START command when a browse is already in progress, or a NEXT or an END issued when a browse of this resource type is not in progress All authorized resource definitions have been retrieved The user associated with the issuing task is not authorized to use this command The user associated with the issuing task is not authorized to use this command The user associated with the issuing task is not authorized to use this command The task number does not exist The task number is a system task, not a user task The user is not authorized for this command All authorized resource definitions have been retrieved. All data areas specified on this command are left unchanged The requested log stream name was not found A START has been given when a browse is already in progress, or a NEXT or an END has been given without a preceding START The browse token is not valid

END

2

NOTAUTH

100

INQUIRE STATISTICS

NOTAUTH

100

INQUIRE STORAGE

NOTAUTH

100

TASKIDERR

1 2

INQUIRE STREAMNAME

NOTAUTH END

100 2

NOTFND ILLOGIC

1 1

2

Chapter 9. RESP2 values and their meanings

299

RESP2 values
Command INQUIRE SYSDUMPCODE Condition END RESP2 2 Meaning There are no more resource definitions of this type The user associated with the issuing task is not authorized to use this command A START command has been issued when a browse is already in progress or a NEXT or an END command issued when a browse of this resource type is not in progress The named dump code cannot be found The user associated with the issuing task is not authorized to use this command The named task cannot be found The task is executing a type of transaction which is not subject to this command operator The user associated with the issuing task is not authorized to use this command SUSPENDVALUE is specified but significant characters are lost TCLASS is specified but CLASS is named. The user should specify the TRANCLASS option Requested data is held on a data profile, but the data is not available

NOTAUTH

100

ILLOGIC

1

NOTFND

1

INQUIRE SYSTEM

NOTAUTH

100

INQUIRE TASK

TASKIDERR

1 2

NOTAUTH

100

INVREQ

1

3

10

300

CICS User’s Handbook

RESP2 values
Command INQUIRE TASK LIST Condition NOTAUTH RESP2 100 Meaning The user associated with the issuing task is not authorized to use this command The named task class cannot be found The user associated with the issuing task is not authorized to use this command TCPIP=NO has been specified in the system initialization table (SIT) The user associated with the issuing task is not authorized to use this command Named TCPIPSERVICE was not found A START command has been issued when a browse is already in progress or a NEXT or an END command issued when a browse of this resource type is not in progress There are no more resource definitions of this type TCPIP not available (TCPIP=NO) TCPIP is closed The user associated with the issuing task is not authorized to use this command There are no more resource definitions of this type Browse sequence error

INQUIRE TCLASS

TCIDERR NOTAUTH

1 100

INQUIRE TCPIP

INVREQ

4

NOTAUTH

100

INQUIRE TCPIPSERVICE

NOTFND ILLOGIC

3 1

END

2

INVREQ

4 5 100

NOTAUTH

INQUIRE TDQUEUE

ENDCOND

2

ILLOGIC

1

Chapter 9. RESP2 values and their meanings

301

RESP2 values
Command Condition NOTAUTH RESP2 100 Meaning The user associated with the issuing task is not authorized to use this command The user associated with the issuing task is not authorized to access this particular resource in the way required by this command The named queue cannot be found No errors There are no more resource definitions of this type A START has been given when a browse is already in progress or a NEXT or an END has been given when a browse of this resource type is not in progress The user associated with the issuing task is not authorized to use this command The named terminal cannot be found The user associated with the issuing task is not authorized to use this command The user associated with the issuing task is not authorized to use this command CICS was initialized without support for at least one of the components listed in the command; trace levels were returned for all other components

101

QIDERR NORMAL INQUIRE TERMINAL END

1 0 2

ILLOGIC

1

NOTAUTH

100

TERMIDERR

1

INQUIRE TRACEDEST

NOTAUTH

100

INQUIRE TRACEFLAG

NOTAUTH

100

INQUIRE TRACETYPE

NOTFND

1

302

CICS User’s Handbook

RESP2 values
Command Condition NOTAUTH RESP2 100 Meaning The user associated with the issuing task is not authorized to use this command The TRANCLASS definition is in use The user associated with the issuing task is not authorized to use this command The user associated with the issuing task is not authorized to access the particular resource in the way required by this command The transaction class cannot be found There are no more resource definitions of this type A START has been given when a browse is already in progress or a NEXT or an END has been given when a browse of this resource type is not in progress The user associated with the issuing task is not authorized to use this command The dump code cannot be found There are no more resource definitions of this type A START has been given when a browse is already in progress or a NEXT or an END has been given when a browse if this resource type is not in progress

INQUIRE TRANCLASS

INVREQ NOTAUTH

12 100

101

TCIDERR

1

INQUIRE TRANDUMPCODE

END

2

ILLOGIC

1

NOTAUTH

100

NOTFND

1

INQUIRE TRANSACTION

END

2

ILLOGIC

1

Chapter 9. RESP2 values and their meanings

303

RESP2 values
Command Condition TRANSIDERR INVREQ RESP2 1 3 Meaning The transaction could not be found The TCLASS option has been specified in this INQUIRE command, and the transaction belongs to a class that is not one of the numbered classes DFHTCL00 through DFHTCL10 The profile definition associated with the transaction is not available The user associated with the issuing task is not authorized to use this command The user associated with the issuing task is not authorized to access this particular resource in the way required by this command There are no more resource definitions of this type A START has been given when a browse is already in progress or a NEXT or an END has been given when a browse if this resource type is not in progress The TSMODEL does not exist The user associated with the issuing task is not authorized to use this command The user associated with the issuing task is not authorized to access this particular resource in the way required by this command

NORMAL

10

NOTAUTH

100

101

INQUIRE TSMODEL

END

2

ILLOGIC

1

NOTFND NOTAUTH

1 100

101

304

CICS User’s Handbook

RESP2 values
Command INQUIRE TSPOOL Condition END RESP2 2 Meaning There are no more resource definitions of this type A START has been given when a browse is already in progress or a NEXT or an END has been given when a browse if this resource type is not in progress The TSPOOL does not exist The user associated with the issuing task is not authorized to use this command The user associated with the issuing task is not authorized to access this particular resource in the way required by this command There are no more resource definitions of this type The specified SYSID does not exist in any TYPE=SHARED entry in the temporary storage table When INQUIRE TSQUEUE NEXT is specified, the NEXT queue to be browsed has a Queuename of more than 8 significant characters. The queue name is truncated, some significant characters are lost. This TSQNAME cannot be deleted as it was written by CICS using PUTQ macro

ILLOGIC

1

NOTFND NOTAUTH

1 100

101

INQUIRE END TSQUEUE/TSQNAME INVREQ

2

1

2

4

Chapter 9. RESP2 values and their meanings

305

RESP2 values
Command Condition ILLOGIC RESP2 1 Meaning A START has been given when a browse is already in progress, or a NEXT or an END has been given when a browse of this resource type is not in progress The user associated with the issuing task is not authorized to use this command The user associated with the issuing task is not authorized to access this particular resource in the way required by this command The POOLNAME does not exist The temporary storage queue cannot be found The SYSID does not map to a shared pool An error has occurred in the shared TS server An I/O error has occurred on the coupling facility All authorized resource definitions have been retrieved. All data areas specified on this command are left unchanged A browse of this resource type is already in progress, or an INQUIRE UOW START command has not been issued A named UOW cannot be found A use of this command is not authorized There are no more UOW/data set pairs

NOTAUTH

100

101

POOLERR QIDERR SYSIDERR

3 1 3 4 5

INQUIRE UOW

END

2

ILLOGIC

1

UOWNOTFOUND NOTAUTH

1 100

INQUIRE UOWDSNFAIL

END

2

306

CICS User’s Handbook

RESP2 values
Command Condition ILLOGIC RESP2 1 Meaning A START has been given when a browse is already in progress, or a NEXT has been given without a preceding START A use of this command is not authorized All enqueues have been retrieved For INQUIRE UOQENQ START - a browse of this resource is already in progress For INQUIRE UOWENQ NEXT and INQUIRE UOWENQ END - an INQUIRE UOWENQ START command has not been issued The named UOW cannot be found A use of this command is not authorized All authorized resource definitions have been retrieved For INQUIRE UOQLINK START - a browse of this resource is already in progress For INQUIRE UOWLINK NEXT and INQUIRE UOWLINK END - an INQUIRE UOWLINK START command has not been issued The named UOW-link cannot be found The named UOW cannot be found A use of this command is not authorized

NOTAUTH

100

INQUIRE UOWENQ

END ILLOGIC

2 1

UOWNOTFOUND NOTAUTH

1 100

INQUIRE UOWLINK

END

2

ILLOGIC

1

UOWLNOTFOUND UOWNOTFOUND NOTAUTH

1 1 100

Chapter 9. RESP2 values and their meanings

307

RESP2 values
Command INQUIRE VOLUME Condition VOLIDERR RESP2 1 Meaning The program has issued an INQUIRE VOLUME browse command. This command is withdrawn VTAM is not present in the system The user associated with the issuing task is not authorized to use this command An invalid value was supplied for one of the options The user associated with the issuing task is not authorized to use this command A distributed program link server application specified the function-shipping session (its principal facility) on the CONVID option A distributed program link server application specified the function-shipping session (its principal facility) on the CONVID option A distributed program link server application specified the function-shipping session (its principal facility) on the CONVID option A distributed program link server application specified the function-shipping session (its principal facility) on the CONVID option

INQUIRE VTAM

INVREQ NOTAUTH

1 100

INQUIRE WEB

INVREQ

11

NOTAUTH

100

ISSUE ABEND

INVREQ

200

ISSUE ABORT

INVREQ

200

ISSUE ADD

INVREQ

200

ISSUE CONFIRMATION

INVREQ

200

308

CICS User’s Handbook

RESP2 values
Command ISSUE END Condition INVREQ RESP2 200 Meaning A distributed program link server application specified the function-shipping session (its principal facility) on the CONVID option A distributed program link server application attempted to send on its function-shipping session, its principal facility A distributed program link server application attempted to send on its function shipping session, its principal facility A distributed program link server application attempted to send on its function shipping session, its principal facility A distributed program link server application specified the function-shipping session (its principal facility) on the CONVID option A distributed program link server application specified the function-shipping session (its principal facility) on the CONVID option A distributed program link server application specified the function-shipping session on the CONVID option

ISSUE ENDFILE

INVREQ

200

ISSUE ENDOUTPUT

INVREQ

200

ISSUE EODS

INVREQ

200

ISSUE ERASE

INVREQ

200

ISSUE ERASEAUP

INVREQ

200

ISSUE ERROR

INVREQ

200

Chapter 9. RESP2 values and their meanings

309

RESP2 values
Command ISSUE NOTE Condition INVREQ RESP2 200 Meaning A distributed program link server application specified the function-shipping session (its principal facility) on the CONVID option A distributed program link server application specified the function-shipping session (its principal facility) on the CONVID option A distributed program link server application specified the function-shipping session (its principal facility) on the CONVID option A distributed program link server application specified the function-shipping session (its principal facility) on the CONVID option A distributed program link server application specified the function-shipping session (its principal facility) on the CONVID option A distributed program link server application specified the function-shipping session (its principal facility) on the CONVID option A distributed program link server application specified the function-shipping session (its principal facility) on the CONVID option

ISSUE PREPARE

INVREQ

200

ISSUE PRINT

INVREQ

200

ISSUE QUERY

INVREQ

200

ISSUE RECEIVE

INVREQ

200

ISSUE REPLACE

INVREQ

200

ISSUE RESET

INVREQ

200

310

CICS User’s Handbook

RESP2 values
Command ISSUE SEND Condition INVREQ RESP2 200 Meaning A distributed program link server application specified the function-shipping session (its principal facility) on the CONVID option A distributed program link server application specified the function-shipping session (its principal facility) on the CONVID option A distributed program link server application specified the function-shipping session (its principal facility) on the CONVID option A LINK command with the INPUTMSG option is issued for a program that is not associated with a terminal, or that is associated with an APPC logical unit, or an IRC session The SYNCONRETURN option is specified but the program issuing the link request (the client program) is already in conversation with a mirror task (that is, a logical unit-of-work (LUW) is in progress) in the remote region specified on the SYSID option. In this case, the client program is in an incorrect state to support the SYNCONRETURN option

ISSUE SIGNAL (APPC)

INVREQ

200

ISSUE WAIT

INVREQ

200

LINK

INVREQ

8

14

Chapter 9. RESP2 values and their meanings

311

RESP2 values
Command Condition RESP2 15 Meaning The program issuing the link request is already in conversation with a mirror task and the TRANSID specified is different from the transaction identifier of the active mirror The TRANSID specified is all blanks A LINK command with the INPUTMSG option is issued for a program that is the subject of a DPL request; that is, SYSID is also specified The program manager domain has not yet been initialized. This is probably due to a link request having been made in a first stage PLT The COMMAREA length is less than 0 or greater than 32767 The length specified on the DATALENGTH option is a negative value The length specified on the DATALENGTH option is greater than the length specified on the LENGTH option The COMMAREA address is zero, but the COMMAREA length is non zero The INPUTMSG length < 0 or > 32767 A resource security check has failed on PROGRAM(name)

16 19

30

LENGERR

11

12

13

26

27 NOTAUTH 101

312

CICS User’s Handbook

RESP2 values
Command Condition PGMIDERR RESP2 1 Meaning A program has no entry in the PPT and either program autoinstall was switched off, or the program autoinstall control program indicated that the program should not be autoinstalled A program is disabled A program cannot be loaded because This was the first load of the program and the program load failed, usually because the load module could not be found This was a subsequent load of the program, but the first load failed In order to reset the load status the load module must be in the DFHRPL concatenation, and a SET PROGRAM NEWCOPY will be required The program autoinstall control program failed either because the program autoinstall control program is incorrect, incorrectly defined, or as a result of an abend in the program autoinstall control program. Program autoinstall is disabled and message DFHPG0202 or DFHPG0203 written to the CSPL The model returned by the program autoinstall control program is not defined in the PPT table, or is not enabled

2 3

21

22

Chapter 9. RESP2 values and their meanings

313

RESP2 values
Command Condition RESP2 23 Meaning The program autoinstall control program returned invalid data Define for the program failed due to autoinstall returning an invalid program name or definition The SYNCONRETURN was specified and the server program was unable successfully to take a syncpoint. The server program has taken a rollback, and all changes made to recoverable resources in the remote region, within the current UOW, are backed out The SYSID specified cannot be found in the intersystem table, or the link to the specified system is unavailable The remote system specified by SYSID is an LUTYPE6.1-connected system. Distributed program link requests are not supported on LUTYPE6.1 connections An unrecoverable error occurred during the conversation with the mirror (for example, the session failed or the server region failed) The program manager domain has not yet been initialized. This is probably due to a load request having been made in a first stage PLT

24

ROLLEDBACK

29

SYSIDERR

18

20

TERMERR

17

LOAD

INVREQ

30

314

CICS User’s Handbook

RESP2 values
Command Condition LENGERR RESP2 19 Meaning LENGTH is used and the length of the loaded program is not less than 32KB A resource security check has failed on PROGRAM(name) A program, table, or map has no entry in the PPT and either program autoinstall was switched off, or the program autoinstall control program indicated that the program should not be autoinstalled A program is disabled A program cannot be loaded because This was the first load of the program and the program load failed, usually because the load module could not be found This was a subsequent load of the program, but the first load failed In order to reset the load status the load module must be in the DFHRPL concatenation, and a SET PROGRAM NEWCOPY will be required The installed program definition is for a remote program

NOTAUTH

101

PGMIDERR

1

2 3

9

Chapter 9. RESP2 values and their meanings

315

RESP2 values
Command Condition RESP2 21 Meaning The program autoinstall control program failed either because the program autoinstall control program is incorrect, incorrectly defined, or as a result of an abend in the program autoinstall control program. Program autoinstall is disabled and message DFHPG0202 or DFHPG0203 written to the CSPL The model returned by the program autoinstall control program was not defined in the PPT table, or was not enabled The program autoinstall control program returned invalid data Define for the program failed due to autoinstall returning an invalid program name or definition POINT value is outside the range 1–255 POINT value is not defined in the MCT DATA1 value is not valid DATA2 value is not valid DATA1 value not specified for an MCT operation that required it DATA2 value not specified for an MCT operation that required it The user associated with the issuing task is not authorized to use this command

22

23

24

MONITOR

INVREQ

1 2 3 4 5

6

PERFORM DELETSHIPPED

NOTAUTH

100

316

CICS User’s Handbook

RESP2 values
Command PERFORM DUMP Condition SUPPRESSED RESP2 1 Meaning The dump was not taken because the number of dumps with this dump code exceeds the maximum for the code The dump was not taken because the system dump table entry for this code indicates no system dump The dump was not taken because it was suppressed by a user exit program The dump was not taken because system dumps are suppressed globally The dump is incomplete due to lack of dump data-set space CICS cannot complete the dump because of insufficient storage TITLELENGTH is greater than 80 bytes CALLERLENGTH is greater than 8 bytes The DUMPCODE contains leading or imbedded blanks CICS is not authorized by MVS to take dumps An error occurs during system dumping MVS cannot process the dump because there is no dump data set or because it is full An error occurred in the CICS routine that issues MVS SDUMP requests The MVS dump routine is busy. Retry the command The user associated with the issuing task is not authorized to use this command

2

3

8

NOSPACE

4

NOSTG

5

INVREQ

6 7 13

IOERR

9 10 12

13

SYSBUSY NOTAUTH

11 100

Chapter 9. RESP2 values and their meanings

317

RESP2 values
Command PERFORM ENDAFFINITY Condition INVREQ RESP2 25 26 Meaning The connection is still in service There may be recovery information outstanding for the connection. RECOVSTATUS has a value other than NORECOVDATA See message DFHZC0178. VTAM could not end the affinity for a reason other than 35 (NOTFOUND) or 36 (SESSIONS ACTIVE) Enter NETID. NETID was not specified, and cannot be obtained from the installed connection. This may be because the connection does not exist, or because it does not contain a NETID value VTAM could not find an affinity for the values input VTAM could not end the affinity because the connection had some sessions active See message DFHZC0176. A VTAM error prevented the CHANGE AFFINITY macro being carried out There is no clock in the system The user associated with the issuing task is not authorized to use this command No ESM is installed, or the ESM is inactive The ESM is temporarily inactive and cannot perform the action requested

32

34

35 36

37

PERFORM RESETTIME

INVREQ NOTAUTH

1 100

PERFORM SECURITY REBUILD

INVREQ

1

5

318

CICS User’s Handbook

RESP2 values
Command Condition IOERR RESP2 3 Meaning Error returned from ESM. The return code is in ESMRESP, if the option was used The user associated with the issuing task is not authorized to use this command Profiles have been refreshed No action is required, because RACF is at Version 2.1 (or later), and so profiles are refreshed automatically A security rebuild is currently in progress A normal shutdown has been requested when shutdown was already in progress The XLT cannot be found The PLT cannot be found XRF is not in effect The transaction specified on SDTRAN is not enabled for shutdown The transaction specified on SDTRAN is not defined as remote The transaction specified on SDTRAN is not enabled The shutdown transaction specified on SDTRAN was not found The user associated with the issuing task is not authorized to use this command

NOTAUTH

100

NORMAL

0 4

SYSBUSY

3

PERFORM SHUTDOWN

INVREQ

1

2 3 4 5

6

7

TRANSIDERR

1

NOTAUTH

100

Chapter 9. RESP2 values and their meanings

319

RESP2 values
Command PERFORM STATISTICS RECORD Condition IOERR RESP2 n Meaning Statistics for at least one of the options chosen were not available; usually the reason for this error is corruption of the memory in which they are accumulated. (See below) The user associated with the issuing task is not authorized to use this command Statistics for at least one of the options chosen were not available because CICS was initialized without support for the function. (See below) The values of “n” are as follows: 1 AUTOINSTALL 2 CONNECTION 3 DISPATCHER 6 FILE 8 JOURNALNUM and JOURNALNAME 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

NOTAUTH

100

NOTFND

n

320

CICS User’s Handbook

RESP2 values
Command POST Condition INVREQ RESP2 4 5 6 200 Meaning Hours are out of range Minutes are out of range Seconds are out of range The command was called in a distributed program link server program The RESID is not valid The RESTYPE is not valid The RESID value for RESTYPE (SPCOMMAND) is not valid The RESCLASS is not defined to the external security manager (ESM) The resource is not protected Possible causes include RESCLASS not active No profile found QIDERR 1 ESM not active No indirect queue name associated with the given RESID has been found The RESIDLENGTH value is not valid, that is, not in the range 1–246 The CVDA value is not valid for the LOGMESSAGE The RESID is invalid or filled with blanks The external security manager (ESM) is inactive or not present The file name referred to in the FILE option cannot be found in the FCT

PURGE MESSAGE

INVREQ

QUERY SECURITY

NOTFND

1 2 3

5

8

LENGERR

6

INVREQ

7

9 10

READ

FILENOTFOUND

1

Chapter 9. RESP2 values and their meanings

321

RESP2 values
Command Condition LENGERR RESP2 10 Meaning Neither the LENGTH nor SET options have been specified on a READ command for a file with variable-length records or for a BDAM file with variable-length or undefined-format records The length of a record read with the INTO option specified exceeds the value specified in the LENGTH option; the record is truncated, and the data area supplied in the LENGTH option is set to the actual length of the record An incorrect length is specified for a file with fixed-length records Read is not allowed according to the file entry specification in the FCT or a read command with the UPDATE option has been issued to a file where update operations are not allowed according to the file entry specification in the FCT The KEYLENGTH and GENERIC options are specified and the length specified in the KEYLENGTH option is greater than or equal to the length of a full key The KEYLENGTH option is specified (but the GENERIC option is not specified), and the specified length does not equal the length defined for the data set to which this file refers

11

13

INVREQ

20

25

26

322

CICS User’s Handbook

RESP2 values
Command Condition RESP2 28 Meaning Following a READ UPDATE command for a file, another READ UPDATE command is issued for a file referencing the same data set before exclusive control is released by a REWRITE, UNLOCK, or DELETE command A BDAM key conversion error occurred The KEYLENGTH and GENERIC options are specified, and the length specified in the KEYLENGTH option is less than or equal to zero The command does not conform to the format of READ for a user-maintained table; for example if GTEQ is specified with UPDATE A READ to a KSDS file that was being accessed in RLS mode specified the RBA keyword. RLS mode does not support relative byte address access to KSDS data sets A READ request to a non-RLS file specified CONSISTENT A READ request to a non-RLS file specified REPEATABLE A READ request to a non-RLS file specified NOSUSPEND, which is not allowed because the file is not a VSAM file accessed in RLS mode

40 42

44

51

52

53

55

Chapter 9. RESP2 values and their meanings

323

RESP2 values
Command Condition DISABLED RESP2 50 Meaning A file was initially defined as disabled and has not since been enabled or it has been disabled by an EXEC CICS SET FILE or the CEMT SET FILE command The requested file is CLOSED and UNENABLED or the requested file is OPEN and in use by other transactions, but a CLOSE request against it has been received or a READ command has been issued against a data set that is quiesced, or is being quiesced, as a result of a SET DSNAME QUIESCED or IMMQUIESCED command The remote system indicated a failure that does not correspond to a known condition An attempt to retrieve a record based on the search argument provided is unsuccessful or, for user-maintained data tables, an attempt to read a record is unsuccessful because there is no entry with the specified key in the data table A resource security check has failed on FILE(filename)

NOTOPEN

60

ISCINVREQ

70

NOTFND

80

NOTAUTH

101

324

CICS User’s Handbook

RESP2 values
Command Condition LOADING RESP2 104 Meaning A READ UPDATE has been issued for a user-maintained data table that is currently being loaded or a READ GENERIC has been issued for a user-maintained data table that is currently being loaded An attempt has been made to read a record either specifying the UPDATE keyword, or specifying (explicitly or implicitly) CONSISTENT or REPEATABLE, but the record was locked by a retained lock The NOSUSPEND keyword was specified and the record was locked by an active lock A VSAM error has occurred which does not fall within one of the other CICS response categories There has been an I/O error during the READ operation The SYSID option specified a name that is neither the local nor the remote system (made known to CICS by defining a CONNECTION); or the link to the remote system is closed. A record has been retrieved by way of an alternate index with the NONUNIQUEKEY attribute, and another alternate index record with the same key follows.

LOCKED

106

RECORDBUSY

107

ILLOGIC

110

IOERR

120

SYSIDERR

130

DUPKEY

140

Chapter 9. RESP2 values and their meanings

325

RESP2 values
Command READNEXT Condition FILENOTFOUND RESP2 1 Meaning The file name referred to in the FILE option cannot be found in the FCT Neither the LENGTH nor SET options have been specified for a file with variable-length records or for a BDAM file with undefined-format records The length of a record read with the INTO option specified exceeds the value specified in the LENGTH option; the record is truncated, and the data areas supplied in the LENGTH option is set to the actual length of the record An incorrect length is specified for a file with fixed-length records The FILE definition does not allow updates The KEYLENGTH option is specified for a generic browse (that is one where GENERIC was specified on the STARTBR or the last RESETBR) and the value of KEYLENGTH was greater than the full key length The KEYLENGTH option is specified for a nongeneric browse, and the specified length does not equal the length defined for the data set to which this file refers The REQID, if any, does not match that of any successful STARTBR command

LENGERR

10

11

13

INVREQ INVREQ

20 25

26

34

326

CICS User’s Handbook

RESP2 values
Command Condition RESP2 37 Meaning The type of record identification used to access a data set during the browse is changed by the READNEXT command The KEYLENGTH option is specified for a generic browse (that is one where GENERIC was specified on the STARTBR or the last RESETBR) and the value of KEYLENGTH is less than zero CONSISTENT is not allowed because the file is not a VSAM file that is accessed in RLS mode REPEATABLE is not allowed because the file is not a VSAM file that is accessed in RLS mode UPDATE is not allowed because the file is not a VSAM file that is accessed in RLS mode NOSUSPEND is not allowed because the file is not a VSAM file that is accessed in RLS mode The remote system indicated a failure that does not correspond to a known condition An attempt to retrieve a record based on the search argument provided is unsuccessful An end-of-file condition has been detected during a browse A resource security check has failed on FILE(filename)

42

52

53

54

55

ISCINVREQ

70

NOTFND

80

ENDFILE

90

NOTAUTH

101

Chapter 9. RESP2 values and their meanings

327

RESP2 values
Command Condition LOCKED RESP2 106 Meaning The read request specified the UPDATE keyword, or one of the read integrity keywords CONSISTENT or REPEATABLE, or the file resource definition specified read integrity, but VSAM held a retained lock against the record NOSUSPEND was specified on the request but VSAM held an active lock against the record, which would cause the request to wait A VSAM error has occurred which does not fall within one of the other CICS response categories There has been an I/O error during the READNEXT command The SYSID option specifies a name that is neither the local nor the remote system (made known to CICS by defining a CONNECTION); or the link to the remote system is closed. A record has been retrieved by way of an alternate index with the NONUNIQUEKEY attribute, and another alternate index record with the same key follows The file name referred to in the FILE option cannot be found in the FCT Neither the LENGTH nor SET options have been specified for a file with variable-length records

RECORDBUSY

107

ILLOGIC

110

IOERR

120

SYSIDERR

130

DUPKEY

140

READPREV

FILENOTFOUND

1

LENGERR

10

328

CICS User’s Handbook

RESP2 values
Command Condition RESP2 11 Meaning The length of a record read with the INTO option specified exceeds the value specified in the LENGTH option; the record is truncated, and the data area supplied in the LENGTH option is set to the actual length of the record An incorrect length is specified for a file with fixed-length records The FILE definition does not allow updates A READPREV command is issued for a file for which the previous STARTBR or RESETBR command has the GENERIC option The KEYLENGTH option is specified and the specified length does not equal the length defined for the data set this file refers to The type of record identification used to access a data set during the browse is changed A READPREV is issued for a BDAM file The REQID, if any, does not match that of any successful STARTBR command CONSISTENT is not allowed because the file is not a VSAM file that is accessed in RLS-mode REPEATABLE is not allowed because the file is not a VSAM file that is accessed in RLS-mode

13

INVREQ

20 24

26

37

39 41

52

53

Chapter 9. RESP2 values and their meanings

329

RESP2 values
Command Condition RESP2 54 Meaning UPDATE is not allowed because the file is not a VSAM file that is accessed in RLS-mode NOSUSPEND is not allowed because the file is not a VSAM file that is accessed in RLS-mode The remote system indicated a failure that does not correspond to a known condition An attempt to retrieve a record based on the search argument provided is unsuccessful An end-of-file condition has been detected during a browse A resource security check has failed on FILE(filename) The read request specified the UPDATE keyword, or one of the read integrity keywords CONSISTENT or REPEATABLE, or the file resource definition specified read integrity, but VSAM held a retained lock against the record NOSUSPEND was specified on the request but VSAM held an active lock against the record, which would cause the request to wait A VSAM error has occurred which does not fall within one of the other CICS response categories There has been an I/O error during the browse

55

ISCINVREQ

70

NOTFND

80

ENDFILE

90

NOTAUTH

101

LOCKED

106

RECORDBUSY

107

ILLOGIC

110

IOERR

120

330

CICS User’s Handbook

RESP2 values
Command Condition SYSIDERR RESP2 130 Meaning The SYSID option specified a name that has not been defined to CICS as a remote system (defined by defining a CONNECTION); or the link to the remote system is closed. A record has been retrieved by way of an alternate index with the NONUNIQUEKEY attribute, and another alternate index record with the same key exists A distributed program link server application specified the function-shipping session (its principal facility) on the CONVID option A program, table, or map has no entry in the PPT A program, table, or map is disabled The installed program definition is for a remote program An invalid attempt has been made by a program to release itself A RELEASE command has been issued for a program that is not loaded A RELEASE command has been issued for a program that is loaded, without the HOLD option, by another task A program has been defined with RELOAD=YES. It must be released by a FREEMAIN rather than a RELEASE command

DUPKEY

140

RECEIVE

INVREQ

200

RELEASE

PGMIDERR

1 2 9

INVREQ

5

6

7

17

Chapter 9. RESP2 values and their meanings

331

RESP2 values
Command Condition RESP2 30 Meaning The program manager domain has not yet been initialized The file name referred to in the FILE option cannot be found in the FCT The KEYLENGTH and GENERIC options are specified and the length specified in the KEYLENGTH option is greater than or equal to the length of a full key The KEYLENGTH option is specified (but the GENERIC option is not specified), and the specified length does not equal the length defined for the data set to which this file refers The REQID, if any, does not match that of any successful STARTBR command The KEYLENGTH and GENERIC options are specified, and the length specified in the KEYLENGTH option is less than zero A RESETBR command to a KSDS file that was being accessed in RLS mode specified the RBA keyword. RLS mode does not support RBA access to KSDS data sets The remote system indicated a failure that does not correspond to a known condition An attempt to retrieve a record based on the search argument provided has been unsuccessful

RESETBR

FILENOTFOUND

1

INVREQ

25

26

36

42

51

ISCINVREQ

70

NOTFND

80

332

CICS User’s Handbook

RESP2 values
Command Condition NOTAUTH RESP2 101 Meaning A resource security check has failed on FILE(filename) A VSAM error has occurred which does not fall within one of the other CICS response categories There has been an I/O error during the file control operation The SYSID option specified a name that is neither the local nor the remote system (made known to CICS by defining a CONNECTION); or the link to the remote system is closed. The user associated with the issuing task is not authorized to use this command A RETURN command with the TRANSID option has been issued by a program that is not associated with a terminal A RETURN command with the COMMAREA or IMMEDIATE option has been issued in a program that is not at the highest logical level A RETURN command with the TRANSID option has been issued in a program that is associated with an APPC logical unit

ILLOGIC

110

IOERR

120

SYSIDERR

130

RESYNC ENTRYNAME

NOTAUTH

100

RETURN

INVREQ

1

2

4

Chapter 9. RESP2 values and their meanings

333

RESP2 values
Command Condition RESP2 8 Meaning A RETURN command with the INPUTMSG option has been issued for a program that is not associated with a terminal, or that is associated with an APPC logical unit, or an IRC session PG domain is not initialized. Parameters are not allowed on the EXEC RETURN statement in first stage PLT programs A RETURN command has been issued with an INPUTMSG option in a program invoked by DPL The COMMAREA length is less than 0 or greater than 32763 The COMMAREA ADDRESS passed was zero, but the commarea length was non-zero The INPUTMSG LENGTH was less than 0 or greater than 32767 The file name referred to in the FILE option cannot be found in the FCT The length option has not been specified for a file with variable-length records, or for a BDAM file with undefined format records The length specified exceeds the maximum record size An incorrect length is specified for a file with fixed-length records

30

200

LENGERR

11

26

27

REWRITE

FILENOTFOUND

1

LENGERR

10

12

14

334

CICS User’s Handbook

RESP2 values
Command Condition INVREQ RESP2 30 Meaning A REWRITE command has been issued without a token and no previous READ for UPDATE (also without a token) can be found A REWRITE command has attempted to change the length of a BDAM variable length record or block A REWRITE instruction included a token whose value cannot be matched against any token in use for an existing READ for UPDATE request NOSUSPEND is not allowed because the file is not a VSAM file accessed in RLS mode The remote system indicated a failure that does not correspond to a known condition No space is available on the direct access device for adding the updated record to the data set For user-maintained data tables, CICS is unable to get sufficient storage in the CICS address space to store the updated data table entry A resource security check has failed on FILE(filename)

46

47

55

ISCINVREQ

70

NOSPACE

100

103

NOTAUTH

101

Chapter 9. RESP2 values and their meanings

335

RESP2 values
Command Condition LOCKED RESP2 106 Meaning When updating a record via a base key or an alternate key, an attempt was made to modify an alternate key contained within the record (not the key by which the update was made) and the new value of the alternate key is the subject of a retained lock held by another transaction The NOSUSPEND keyword was specified and the record was found to be locked by an active lock in VSAM A VSAM error has occurred which does not fall within one of the other CICS response categories There has been an I/O error during the file control operation The SYSID option specified a name that is neither the local nor a remote system (made known to CICS by defining a CONNECTION); or the link to the remote system is closed. An attempt has been made to rewrite a record to a data set whose upgrade set has an alternate index with the UNIQUEKEY attribute, if the corresponding alternate key already exists in the alternate index Hours are out of range Minutes are out of range Seconds are out of range

RECORDBUSY

107

ILLOGIC

110

IOERR

120

SYSIDERR

130

DUPREC

150

ROUTE

INVREQ

4 5 6

336

CICS User’s Handbook

RESP2 values
Command Condition RESP2 200 Meaning BMS commands are not supported for distributed program link A distributed program link server application has attempted to send on its function-shipping session (its principal facility) or, for SEND (APPC), a distributed program link server application has specified the function-shipping session (its principal facility) on the CONVID option A distributed program link server application has attempted to send on its function-shipping session (its principal facility) Command is not allowed for a distributed program link server program Command is not allowed for a distributed program link server program Command is not allowed for a distributed program link server program Command is not allowed for a distributed program link server program A distributed program link server application has specified the function-shipping session (its principal facility) on the CONVID option

SEND

INVREQ

200

SEND CONTROL

INVREQ

200

SEND MAP

INVREQ

200

SEND PAGE

INVREQ

200

SEND PARTNSET

INVREQ

200

SEND TEXT

INVREQ

200

SEND TEXT MAPPED

INVREQ

200

Chapter 9. RESP2 values and their meanings

337

RESP2 values
Command SEND TEXT NOEDIT Condition INVREQ RESP2 200 Meaning Command is not allowed for a distributed program link server program VTAM is not in use in this system The MAXREQS value is not in the range 0–999 One of the modules invoked by DFHZATDX (DFHZATA and DFHZATD) cannot be found The user associated with the issuing task is not authorized to use this command The program name cannot be found ACQSTATUS|CONNSTATUS was specified for a non-APPC connection 1. ACQUIRED specified with OUTSERVICE 2. ACQUIRED specified for OUTSERVICE connection 3. OUTSERVICE specified for ACQUIRED connection ACQSTATUS|CONNSTATUS has an invalid CVDA value SERVSTATUS has an invalid CVDA value PENDSTATUS or NOTPENDING was specified for a connection that is not APPC or IRC PURGE was specified for connection that is not VTAM PURGETYPE has an invalid CVDA value PENDSTATUS has an invalid CVDA value

SET AUTOINSTALL

INVREQ

1 2 4

NOTAUTH

100

PGMIDERR

3

SET CONNECTION

INVREQ

1

2

3

4 5

6

7 8

338

CICS User’s Handbook

RESP2 values
Command Condition RESP2 11 12 13 14 Meaning SET command named a remote connection EXITTRACING has an invalid CVDA ZCPTRACING has an invalid CVDA EXITTRACING|ZCPTRACING specified for a non-VTAM connection or VTAM not initialized The resource whose name was specified by CONNECTION(data-value) is an indirect link ACQSTATUS|CONNSTATUS cannot be set when system initialized with ISC=NO NOTPENDING cannot be set for a connection which has successfully completed Exchange Lognames processing CONNSTATUS cannot be set to ACQUIRED when in the FREEING state COMMIT, BACKOUT, or FORCE is not valid for this type of connection BACKOUT or FORCE was specified, but was unsuccessful. Some UOWs remain shunted for this connection Other SET parameters were included with the CANCEL or FORCECANCEL option The resource whose name was specified by CONNECTION(name) is the local TCT system entry (TCTSE) Connection is still in service

16

17

18

19

20

21

22

23

25

Chapter 9. RESP2 values and their meanings

339

RESP2 values
Command Condition RESP2 26 Meaning RECOVSTATUS does not have a value of NORECOVDATA. ENDAFFINITY is invalid Wrong connection type for ENDAFFINITY. Affinities can exist only on LU6.1 and LU6.2 connections User PERFORM ENDAFFINITY. The NETID could not be obtained from the installed connection. Therefore, to end affinity you must use the PERFORM ENDAFFINITY command See message DFHZC0178. VTAM could not end the affinity for a reason other than 35 (NOTFOUND) or 36 (SESSIONS ACTIVE) VTAM could not find an affinity for this connection VTAM could not end the affinity because the connection had some sessions active See message DFHZC0176. A VTAM error prevented the CHANGE ENDAFFIN macro being carried out GRSTATUS is not set to REGISTERED or DEREGISTERED NORECOVDATA cannot be set for a connection that is in service NORECOVDATA was specified for a non-APPC connection The named connection could not be found Unexpected error AIDs are successfully canceled No AIDs are canceled

30

31

32

35 36

37

44

45

46

SYSIDERR IOERR NORMAL NORMAL

9 10 58 59

340

CICS User’s Handbook

RESP2 values
Command Condition NOTAUTH RESP2 100 Meaning The user associated with the issuing task is not authorized to use this command Invalid ACCOUNTREC value Invalid AUTHTYPE value Invalid BUSY value Invalid COMAUTHTYPE value Invalid CONNECTERROR value Invalid CONNECTST value Invalid NONTERMREL value Invalid PRIORITY value Invalid SECURITY value Invalid STANDBYMODE value Invalid THREADWAIT value Bad characters in AUTHID Bad characters in COMAUTHID Bad characters in DB2ID Bad characters in MSGQUEUE1 Bad characters in MSGQUEUE2 Bad characters in MSGQUEUE3 Bad characters in PLAN Bad characters in PLANEXITNAME Bad characters in SIGNID Bad characters in STATSQUEUE Both AUTHID and AUTHTYPE specified Both COMAUTHID and COMAUTHTYPE specified

SET DB2CONN

INVREQ

1 2 3 4 5 6 7 9 10 11 12 13 14 15 16 17 18 19 20 21 22 23 24

Chapter 9. RESP2 values and their meanings

341

RESP2 values
Command Condition RESP2 25 Meaning STANDBYMODE(NOCONNECT) and CONNECTERROR(SQLCODE) specified or CONNECTERROR(SQLCODE) specified when STANDBYMODE is NOCONNECT Both PLAN and PLANEXITNAME specified Invalid ACCOUNTREC value COMTHREADLIM exceeds TCBLIMIT or COMTHREADLIM > 2000 or COMTHREADLIM < 0 PURGE CYCLE is too low; that is, < 30 seconds 1. or PURGE CYCLE minutes < 0 2. or PURGE CYCLE seconds < 0 3. or PURGE CYCLE minutes > 59 4. or PURGE CYCLE seconds > 59 TCBLIMIT > 2000 or TCBLIMIT < 4 THREADLIMIT exceeds TCBLIMIT or THREADLIMIT > 2000 or THREADLIMIT < 3 Already connected RCT suffix not allowed RCT suffix not found Wrong level RCT DB2 not active Insufficient authorization Connection error Invalid INIT parms DB2ID cannot be set, CONN active DB2CONN partially discarded RCT suffix invalid

26

27 28

29

32 33

34 35 36 37 39 40 41 42 43 44 45

342

CICS User’s Handbook

RESP2 values
Command Condition RESP2 46 Meaning SET NOTCONNECTED when the FORCE or WAIT option has been specified, but this transaction is itself using the CICS DB2 interface Waiting for DB2 (may occur following a CONNECTST with a CVDA of CONNECT) There is no DB2TRAN currently installed with the specified name Command authorization failure Surrogate authorization failure AUTHTYPE authorization failure Invalid ACTION value Invalid AUTHTYPE value Invalid BUSY value Invalid ENABLESTATUS value Invalid PRIORITY value Invalid THREADWAIT value Bad characters in AUTHID Bad characters in PLAN Bad characters in PLANEXITNAME Both AUTHID and AUTHTYPE specified Both PLAN and PLANEXITNAME specified Entry is disabling PROTECTNUM greater than THREADLIMIT or PROTECTNUM < 0 or PROITECTNUM > 2000 THREADWAIT must be TPOOL with THREADLIMIT=0

NORMAL

38

NOTFND

1

NOTAUTH

100 101 102

SET DB2ENTRY

INVREQ

2 3 4 5 7 8 9 10 11 12 13

14 15

16

Chapter 9. RESP2 values and their meanings

343

RESP2 values
Command Condition RESP2 17 Meaning THREADLIMIT > 2000 or THREADLIMIT < 0 or THREADLIMIT > TCBLIMIT Invalid ACCOUNTREC value SET DISABLED when the FORCE ir WAIT option has been specified, but this transaction itself is using the DB2ENTRY Command authorization failure Resource authorization failure Surrogate authorization failure AUTHTYPE authorization failure There is no DB2ENTRY currently installed with the specified name Bad characters in TRANSID name TRANSID already exisits in another installed DB2TRAN Bad characters in DB2ENTRY name Command authorization failure Resource authorization failure Surrogate authorization failure AUTHTYPE authorization failure There is no DB2TRAN currently installed with the specified name INTERVAL value is invalid INTERVALHRS value is not in the range 0-99 INTERVALMINS value is invalid INTERVALSECS value is invalid

18 19

NOTAUTH

100 101 102 103

NOTFND

1

SET DB2TRAN

INVREQ

2 3

4 NOTAUTH 100 101 102 103 NOTFND 1

SET DELETSHIPPED

INVREQ

1 2 3 4

344

CICS User’s Handbook

RESP2 values
Command Condition RESP2 5 6 7 8 100 Meaning IDLE value is invalid IDLEHRS value is not in the range 0-99 IDLEMINS value is invalid IDLESECS value is invalid The user associated with the issuing task is not authorized to use this command The named data set cannot be found RECOVERED was specified, but the data set was not found ACTION has an invalid CVDA value REMOVE was specified, but the data set is associated with a file definition REMOVE was specified with another option. If you specify remove, it must be the only option present on the command REMOVE was specified but a lock was held on the data set by another INQUIRE or SET DSNAME command, or by CICS file control processing. RECOVERED was specified but CICS is not configured to support “backup while open” (BWO). Check that you have a version of MVS/DFP, DFHSM, and DFDSS that support BWO RECOVERED was specified but the data set has not been opened during this CICS session, so the BWO attributes in the ICF catalog cannot be set

NOTAUTH

SET DSNAME

DSNNOTFOUND

1 15

INVREQ

3 10

12

13

14

16

Chapter 9. RESP2 values and their meanings

345

RESP2 values
Command Condition RESP2 17 Meaning RECOVERED was specified for a BDAM data set, or a VSAM path. This is not supported RECOVERED was specified for a VSAM base data set that had FCTs open. This is not allowed. RECOVERED was specified for an unknown data set, or the data set was not in the ‘forward recovered’ state QUIESCESTATE is specified, but the operation is not supported because DFSMS 1.3, or later, is not installed QUIESCESTATE has an invalid CVDA value BUSY has an invalid CVDA value AVAILABILITY has an invalid CVDA value data A QUIESCESTATE value of QUIESCED or IMMQUIESCED is specified, but is rejected either because q quiesce or unquiesce is already taking place, or because DFSMSdss is currently taking a backup copy of the data set A QUIESCESTATE value of UNQUIESCED is specified, but is rejected by RLS either because an unquiesce is already taking place, or because DFSMSdss is currently taking a backup copy of the data set

18

19

29

30 31 33 34

36

346

CICS User’s Handbook

RESP2 values
Command Condition RESP2 39 Meaning AVAILABILITY, QUIESCESTATE, RESETLOCKS or RETRY is specified for a data set that is a BDAM data set The CICS control block (DSNB) describing the data set has been deleted (by the REMOVE option) by another task before CICS could process the SET command QUIESCESTATE is specified for a data set that is not known to DFSMS as a VSAM data set An invalid CVDA is specified for UOWACTION A QUIESCESTATE value of QUIESCED or IMMQUIESCED is specified without NOWAIT, and the issuing task has updated the data set, or is browsing the data set, in the same unit of work. This is not allowed because: For QUIESCED this would result in a deadlock For IMMQUIESCED this would result in the issuing task being purged A SET DSNAME REMOVE command has been issued by another task. This has been detected after this SET DSNAME command was issued, but before the AVAILABILITY option is processed FAILEDBKOUT, which is obsolete, is specified

40

41

42

43

44

46

Chapter 9. RESP2 values and their meanings

347

RESP2 values
Command Condition RESP2 47 Meaning No file has been opened against the data set since the last cold start of this CICS region, or since the file definition was installed for the data set RECOVERED was specified but an error was raised on accessing the ICF catalog. Ensure that the specified data set is on an SMS managed DASD and is known to the SMS subsystem RECOVERED was specified but an error was raised by the CICS table manager program QUIESCESTATE is specified but the SMSVSAM server is not available QUIESCESTATE is specified, and an unexpected error occurred in DFSMS The specified operation cannot be completed because the data set is migrated. Recall the data set and re-issue the command An error was raised by DFSMS when reading the ICF Catalog to establish the base data set name

IOERR

20

21

35

40

48

49

348

CICS User’s Handbook

RESP2 values
Command Condition SUPPRESSED RESP2 37 Meaning A QUIESCESTATE value of QUIESCED or IMMQUIESCED is specified, but the quiesce of the data set is cancelled by another participating CICS region. This could be for one of the following reasons: A user issued a SET DSNAME UNQUIESCED command AN XCFVSDS global user exit program suppressed the quiesce AN XCFSREQ global user exit program suppressed the close of a file that is open against the data set A QUIESCESTATE value of QUIESCED or IMMQUIESCED is specified, but the quiesce of the data set is cancelled by this CICS region because the quiesce operation timed out. This is probably due to a long-running transaction on another participating CICS region preventing the close of a file that is open against the data set The user associated with the issuing task is not authorized to use this command INITIALDDS has an invalid value SWITCHSTATUS has an invalid CVDA value

38

NOTAUTH

100

SET DUMPDS

INVREQ

1 2

Chapter 9. RESP2 values and their meanings

349

RESP2 values
Command Condition RESP2 3 IOERR 4 Meaning OPENSTATUS has an invalid CVDA value OPEN or SWITCH caused an error opening a data set The user associated with the issuing task is not authorized to use this command The attempt to enable/disble an ENQMODEL failed, because a more generic ENQMODEL is enabled STATE has an invalid CVDA value The ENQMODEL is in the WAITING state The specified ENQMODEL is not installed on this system The user associated with the issuing task is not authorized to use this command The named file is REMOTE The named file is not CLOSED The named file is not DISABLED ADD has an invalid CVDA value BROWSE has an invalid CVDA value BUSY has an invalid CVDA value DELETE has an invalid CVDA value DISPOSITION has an invalid CVDA value EMPTYSTATUS has an invalid CVDA value LSRPOOLID was specified for a non-VSAM data set

NOTAUTH

100

SET ENQMODEL

INVREQ

2

3 IOERR NOTFND 4 1

NOTAUTH

100

SET FILE

INVREQ

1 2 3 4 5 6 7 8 9 10

350

CICS User’s Handbook

RESP2 values
Command Condition RESP2 11 Meaning LSRPOOLID is not in the range 1–8, or the corresponding buffer is not defined READ has an invalid CVDA value STRINGS value is not in the range 1–255, or this is not a VSAM file UPDATE has an invalid CVDA value OPENSTATUS has an invalid CVDA value ENABLESTATUS has an invalid CVDA value DELETE has been specified for a non-VSAM file EMPTYSTATUS has been specified for a non-VSAM file CLOSED or DISABLED has been specified, but this transaction has an incomplete request against the file ENABLED was specified for a file that is currently DISABLING or UNENABLING EXCLUSIVE has an invalid CVDA value EXCLUSIVE has been specified for a non-BDAM file. OPEN, CLOSE, ENABLE or DISABLE has been specified but an exit program running at exit point XFCSREQ instructed CICS not to carry out the command TABLE has an invalid CVDA value MAXNUMREQS value is out of range

12 13

14 16 17 19

20

21

22

23 24

28

29 30

Chapter 9. RESP2 values and their meanings

351

RESP2 values
Command Condition RESP2 31 Meaning The TABLE option is invalid for a BDAM file (must be VSAM for a data table.) The TABLE option is not valid for a file defined with the REUSE option The TABLE option is invalid for a file defined as UNBLOCKED The MAXNUMRECS option is invalid for a BDAM file (must be VSAM for a data table.) The MAXNUMRECS option is invalid for a file defined with the REUSE option The MAXNUMRECS option is invalid for a file defined as UNBLOCKED The TABLE option is invalid when LSRPOOL=0 is specified The USERTABLE option is invalid when record format is not variable CONSISTENT or REPEATABLE is specified for a file that is not accessed in RLS mode The DSNB cannot be disconnected for this file because the file has deferred work outstanding, for which there are retained locks. This means there is at least one shunted UOW, awaiting completion, that has made changes to this file

32

33

34

35

36

37

39

40

41

352

CICS User’s Handbook

RESP2 values
Command Condition RESP2 42 Meaning The SET FILE request cannot be satisfied because the file has deferred work outstanding, for which there are retained locks. This means there is at least one shunted UOW, awaiting completion, that has made changes to this file. The only valid options when a file has deferred work pending are those that change the file state. File state changes are permitted because they may be required to enable the deferred work to be completed The file cannot be discarded because it has deferred work outstanding, for which there are retained locks. This means there is at least one shunted UOW, awaiting completion, that has made changes to this file A file open request cannot be satisfied because the file references a data set that has been marked as unavailable by a SET DSNAME UNAVAILABLE command A file open request cannot be satisfied because the file references an RLS-mode data set that has been quiesced by a SET DSNAME QUIESCED command

43

44

45

Chapter 9. RESP2 values and their meanings

353

RESP2 values
Command Condition RESP2 46 Meaning A file open request cannot be satisfied because the file references an RLS-mode data set that is being copied by a DFSMSdss-initiated non-BWO backup A file open request cannot be satisfied because the file references an RLS-mode data set that is in the process of quiescing by a SET DSNAME QUIESCED command A file open request cannot be satisfied because the file references a data set for which its ICF Catalog entry indicates that a recovery is pending, or is in progress (for example, a CICSVR job is running) An invalid CVDA is specified for the READINTEG option An attempt has been made to open an RLS file when RLS is not supported An invalid CVDA is specified for the RLSACCESS option An attempt has been made to specify RLS access for a BDAM data set An attempt has been made to specify a CICS-maintained data table for a file defined with RLS access

47

48

49

50

51

52

53

354

CICS User’s Handbook

RESP2 values
Command Condition RESP2 54 Meaning A file open request cannot be satisfied because of one of the following reasons: the file is being opened in RLS mode and this region has other files open in non-RLS mode against the data set which it references the file is being opened in non-RLS mode and this region has other files open in RLS mode against the data set which it references the file is being opened in non-RLS mode and this region has unresolved RLS recovery work against the data set which it references LOADTYPE has an invalid CVDA value UPDATEMODEL has an invalid CVDA value EMPTYSTATUS has a CVDA value that is not allowed for a coupling facility data table. EMPTYSTATUS must be NOEMPTYREQ for a coupling facility data table. CFDTPOOL is not specified for a file that refers to a coupling facility data table. KEYLENGTH is not specified for a file that refers to a coupling facility data table, and which specifies LOAD=NO An invalid KEYLENGTH is specified

55 56 57

58

59

60

Chapter 9. RESP2 values and their meanings

355

RESP2 values
Command Condition RESP2 61 Meaning RECORDSIZE is not specified for a file that refers to a coupling facility data table that specifies LOAD=NO An invalid RECORDSIZE is specified Open is specified for a file that refers to a coupling facility data table, but OPEN processing has failed because: The file attributes do not match those specified when the CFDT was created, or A KEYLENGTH or RECORDSIZE has been specified that exceeds the maximum supported OPEN is specified for a file that refers to a coupling facility data table, but OPEN processing has failed because the server is not available An invalid CDFTPOOL name is specified An invalid TABLE name is specified An UPDATEMODEL of CONTENTION is specified for a recoverable coupling facility data table. The update model must be LOCKING for a coupling facility data table that is recoverable The named file cannot be found The user associated with the issuing task is not authorized to use this command

62 63

64

65 66 67

FILENOTFOUND NOTAUTH

18 100

356

CICS User’s Handbook

RESP2 values
Command Condition RESP2 101 Meaning The user associated with the issuing task is not authorized to access this particular resource in the way required by this command OPEN has failed in VSAM, and the RESP2 field contains a VSAM response code CLOSE has failed in VSAM, and the RESP2 field contains a VSAM response code A program required for IRC, DFHCRSP, is unavailable OPENSTATUS has an invalid CVDA value CICS was initialized without IRC support (ISC=NO) No connection has been defined The VTAM APPLID for this CICS is blanks; IRC requires a non-blank APPLID Another CICS using IRC has the same VTAM APPLID as this one; unique names are required IRC rejected the open of this CICS because it had already reached the maximum number of logons IRC support (the DFHIRP module) is below the level required by this CICS system CICS storage is insufficient for the request MVS storage is insufficient (SVC block request rejected)

IOERR

*

*

SET IRC

INVREQ

1

2 4

5 6

7

8

18

NOSTG

9 10

Chapter 9. RESP2 values and their meanings

357

RESP2 values
Command Condition RESP2 11 Meaning MVS storage is insufficient (SUBSYS block request rejected) IRC initialization failed The log on to IRC failed An attempt to attach the node error transaction, CSNC, failed An error occurred closing IRC The user associated with the issuing task is not authorized to use this command The specified journal name was not found An error occurred during an attempt to define the log stream associated with the journal name, or the journal name was incorrectly specified The specified journal name refers to a DASD-only log stream to which a CICS region in another MVS image is currently connected. The request is invalid The system log cannot be changed The ACTION option has an invalid CVDA value The STATUS option has an invalid CVDA value The ACTION option specifies FLUSH or REST for a journal that is not currently connected to a log stream

IOERR

12 13 14

15 NOTAUTH 100

SET JOURNALNAME

JIDERR

1 2

3

INVREQ

2 3 4 5 n

358

CICS User’s Handbook

RESP2 values
Command Condition IOERR RESP2 6 Meaning Either the log stream associated with the journal name cannot be opened, or the journal cannot be opened, or an unrecoverable error has occurred during the flushing of the log buffer to the log stream The user associated with the issuing task is not authorized to use this command The user associated with the issuing task is not authorized to access this particular resource in the way required by this command There are no valid options supported by this command, which is obsolete. Use the SET JOURNALNAME command The connection cannot be found The MODENAME within the connection cannot be found MODENAME ‘SNASVCMG’ was specified The AVAILABLE value is out of range AVAILABLE was specified but CICS is not in session on this connection CLOSED was specified with AVAILABLE ACQSTATUS has an invalid CVDA value This is not a parallel-session APPC group

NOTAUTH

100

101

SET JOURNALNUM

JIDERR

1

SET MODENAME

SYSIDERR

1 2

INVREQ

3

4 5

6 7 8

Chapter 9. RESP2 values and their meanings

359

RESP2 values
Command Condition RESP2 9 Meaning ACQUIRED was specified but CICS is not in session on this connection The user associated with the issuing task is not authorized to use this command STATUS has an invalid CVDA value PERFCLASS has an invalid CVDA value EXCEPTCLASS has an invalid CVDA value EVENTCLASS has an invalid CVDA value CONVERSEST has an invalid CVDA value SYNCPOINTST has an invalid CVDA value The FREQUENCY value is invalid Hours exceed 24, minutes or seconds exceed 59, or total value is out of range The FREQUENCYHRS value is out of range The FREQUENCYMIN value is out of range The FREQUENCYSEC value is out of range The user associated with the issuing task is not authorized to use this command EXITTRACING has an invalid CVDA value The terminal is not a VTAM terminal The user associated with the issuing task is not authorized to use this command

NOTAUTH

100

SET MONITOR

INVREQ

1 2 3 4 5 6 7

8 9 10 NOTAUTH 100

SET NETNAME

INVREQ

27 29

NOTAUTH

100

360

CICS User’s Handbook

RESP2 values
Command SET PROGRAM Condition INVREQ RESP2 1 Meaning DISABLED or DPLSUBSET was specified for a program beginning ‘DFH’ STATUS has an invalid CVDA value NEWCOPY was specified and RESCOUNT is not equal to zero SHARESTATUS has an invalid CVDA value COPY has an invalid CVDA value COPY was specified for a module currently loaded with the HOLD option CEDFSTATUS has an invalid CVDA value You have specified an option that is invalid for a remote program (CEDFSTATUS, COPY, EXECUTIONSET or SHARESTATUS) You have specified an option that is invalid for a map set (CEDFSTATUS or EXECUTIONSET) You have specified an option that is invalid for a partition set (CEDFSTATUS or EXECUTIONSET) EXECUTIONSET has an invalid CVDA The program, map set, or partition set cannot be found The COPY option was specified but CICS could not locate the module The user associated with the issuing task is not authorized to use this command

2 3

4 5 6

9 17

18

19

20 PGMIDERR 7

IOERR

8

NOTAUTH

100

Chapter 9. RESP2 values and their meanings

361

RESP2 values
Command Condition RESP2 101 Meaning The user associated with the issuing task is not authorized to access this particular resource in the way required by this command The INTERVAL value is out of range The ENDOFDAY value is out of range RECORDING has an invalid CVDA value The INTERVALHRS value is out of range The INTERVALMINS value is out of range The INTERVALSECS value is out of range More than one of the interval values has been used and the combination either exceeds 24 hours or is less than 1 minute The ENDOFDAYHRS value is out of range The ENDOFDAYMINS value is out of range The ENDOFDAYSECS value is out of range RESETNOW or RECORDNOW has been specified, but the RECORDING state has not been changed The user associated with the issuing task is not authorized to use this command The dump code cannot be found ACTION has an invalid CVDA value SYSDUMPING has an invalid CVDA value The MAXIMUM value is out of range

SET STATISTICS

INVREQ

1 2 3 4 5 6 7

8 9 10 11

NOTAUTH

100

SET SYSDUMPCODE

NOTFND INVREQ

1 2 4 5

362

CICS User’s Handbook

RESP2 values
Command Condition RESP2 6 7 9 13 14 15 DUPREC 10 Meaning SHUTOPTION has an invalid CVDA value REMOVE is specified with other options The dump code is invalid DUMPSCOPE has an invalid CVDA value RELATED requires MVS/ESA 5.1 DAEOPTION has an invalid CVDA value ADD is specified for a dump code already in the system dump table An error occurred updating the CICS catalog. The entry is changed for the current run, but is not recorded for restarts The CICS catalog full. The entry is changed for the current run, but is not recorded for restarts The user associated with the issuing task is not authorized to use this command The MAXTASKS value is out of range The AKP value is out of range TIME is not in the range 100–3600000 The RUNAWAY value is out of range MROBATCH is not in the range 1–255 DUMPING has an invalid CVDA value AKP was specified, but CICS was initialized without keypointing TIME is less than SCANDELAY PRTYAGING is not in the range 0–65535

IOERR

11

NOSPACE

12

NOTAUTH

100

SET SYSTEM

INVREQ

1 3 5 6 7 9 12

13 14

Chapter 9. RESP2 values and their meanings

363

RESP2 values
Command Condition RESP2 15 20 21 22 Meaning SCANDELAY is not in the range 0–5000 DSALIMIT is not in the range 2MB to 16MB EDSALIMIT is not in the range 10MB to 2GB There is insufficient MVS storage to allocate DSALIMIT There is insufficient MVS storage to allocate EDSALIMIT The GMMLENGTH value is out of range CICS reduced the value you requested for MAXTASKS because of storage constraints; see the NEWMAXTASKS option The user associated with the issuing task is not authorized to use this command The task cannot be found The task is protected by CICS and not eligible for modification with this command PURGETYPE has an invalid CVDA value PRIORITY is not in the range 0–255 The task is not in a valid state for purging The user associated with the issuing task is not authorized to use this command The transaction class cannot be found The MAXIMUM value is not in the range 0–999

23

LENGERR NOSTG

20 16

NOTAUTH

100

SET TASK

TASKIDERR

1 2

INVREQ

3 4 5

NOTAUTH

100

SET TCLASS

TCIDERR INVREQ

1 2

364

CICS User’s Handbook

RESP2 values
Command Condition NOTAUTH RESP2 100 Meaning The user associated with the issuing task is not authorized to use this command TCPIP not available (TCPIP=NO) TCPIP already closed (for SET CLOSED|IMMCLOSE) TCPIP already open (for SET OPEN) STATUS has an invalid CVDA value The OPEN request did not complete because another task subsequently requested a CLSOE of CICS internal sockets support The user associated with the issuing task is not authorized to use this command TCPIP is not available (TCPIP=NO) TCPIP status is closed Port in use CICS is not authorized to use this port TCPIPSERVICE not closed Unknown IP address Invalid value specified in an operand of the SET command (either the STATUS or the URMname is wrong) Invalid status The named TCPIPSERVICE is not found The user associated with the issuing task is not authorized to use this command The queue cannot be found

SET TCPIP

INVREQ

4 5

6 11 12

NOTAUTH

100

SET TCPIPSERVICE

INVREQ

4 4 7 8 9 10 11

NOTFND

12 3

NOTAUTH

100

SET TDQUEUE

QIDERR

1

Chapter 9. RESP2 values and their meanings

365

RESP2 values
Command Condition INVREQ RESP2 2 Meaning TRIGGERLEVEL was specified for an extrapartition queue The TRIGGERLEVEL value is not in the range 0–32767 ATITERMID was specified for an extrapartition queue ATITRANID was specified for an extrapartition queue ATIFACILITY was specified for an extrapartition queue ATIFACILITY has an invalid CVDA value OPENSTATUS has an invalid CVDA value OPENSTATUS was specified for an intrapartition queue ENABLESTATUS has an invalid CVDA value The queue is remote The queue is indirect OPENSTATUS was specified for a DISABLED queue OPENSTATUS was specified, but the JCL DDNAME to which the queue definition points was not found SET not possible because the queue was not closed ATIUSERID was specified for an extrapartition queue The ESM interface is not initialized CICS has received an unknown response from the ESM The ESM did not respond Disabled pending condition SET not possible because the queue was not disabled

3

4 5 6

7 8 9

10 12 13 15

16

18 19 20 21

22 30 31

366

CICS User’s Handbook

RESP2 values
Command Condition RESP2 35 40 IOERR 14 Meaning SET not possible because the queue is in-doubt SET not possible because the queue is CXRF An error occurred opening or closing the data set associated with the queue The queue cannot be set CLOSED because there is no space in the associated data set The user named on the ATIUSERID option is not authorized The user named in the ATIUSERID has been revoked During SECLABEL processing by the external security manager, an error occurred. For information about security labels, see the OS/390 Security Server (RACF) Security Administrator’s Guide, SC28-1915 The user named in the ATIUSERID option is not allowed to access the queue The user associated with the issuing task is not authorized to use this command The user associated with the issuing task is not authorized to access this particular resource in the way required by this command The user associated with the issuing task is not an authorized surrogate for the user specified in ATIUSERID The user named in ATIUSERID is not known to the ESM

17

NOTAUTH

23

24

25

27

100

101

102

USERIDERR

28

Chapter 9. RESP2 values and their meanings

367

RESP2 values
Command SET TERMINAL Condition INVREQ RESP2 1 Meaning TERMSTATUS or ACQSTATUS was specified for IRC sessions or non-VTAM terminal TERMSTATUS or ACQSTATUS has an invalid CVDA value ATISTATUS has an invalid CVDA value ATISTATUS change would result in NOATI and NOTTI CREATESESS was specified for non-VTAM terminal CREATESESS has an invalid CVDA value PAGESTATUS has an invalid CVDA value Trying to put the issuing terminal OUTSERVICE SERVSTATUS has an invalid CVDA value TERMPRIORITY value not in range 0–255 NOTTI cannot be specified for the issuing terminal TTISTATUS has an invalid CVDA value PURGETYPE has an invalid CVDA value TRACING has an invalid CVDA value Invalid option requested for a remote terminal ACQUIRED specified, but terminal is not inservice PURGE specified, but target task has SPURGE=NO on its associated transaction definition EXITTRACING has an invalid CVDA value ZCPTRACING has an invalid CVDA value

2

4 5

6

7 9 11 13 15 17

18 21 22 24 25 26

27 28

368

CICS User’s Handbook

RESP2 values
Command Condition RESP2 29 Meaning EXITTRACING or ZCPTRACING specified for non-VTAM terminal (or VTAM not installed) This is a remote terminal with no associated surrogate SET TERMINAL is not valid for an LU6.2 (APPC) session A permanent transaction has been defined for this terminal (TRANSACTION operand in TERMINAL definition) Attempt made to change TCAM CONTROL on non-TCAM terminal Invalid value supplied for TCAM CONTROL Preset signon failed, terminal remains OUTSERVICE OBFORMATST has an invalid CVDA value RELREQST has an invalid CVDA value DISCREQST has an invalid CVDA value ALTPRTCOPYST has an invalid CVDA value PRTCOPYST has an invalid CVDA value UCTRANST has an invalid CVDA value Options would result in the invalid combination of the alternate printer copy status being set without an alternate printer defined Options would result in the invalid combination of the alternate printer being defined without a primary printer defined

31

33

34

35

36 37

38 39 40 41 42 43 44

45

Chapter 9. RESP2 values and their meanings

369

RESP2 values
Command Condition RESP2 46 Meaning OBFORMATST is specified for a console or 3790 Options would result in the invalid combination of the printer copy status being set without a primary printer defined VTAM not available for VTAM terminal PRINTER and ALTPRINTER option specified for a non-3270 terminal PRTCOPYST of ALTPRTCOPST option specified for a non-3270 terminal Option other than PURGETYPE specified for IRC session Other SET parameters were included with the CANCEL option Purge deferred AIDs are successfully canceled No AIDs are canceled MAPNAME or MAPSETNAME specified, but the terminal is not of a type supported by BMS The named terminal cannot be found The user associated with the issuing task is not authorized to use this command INSTATUS has an invalid CVDA value A TABLESIZE value of < −1 has been specified AUXSTATUS has an invalid CVDA value SWITCHSTATUS has an invalid CVDA value

48

50 51

52

54

57

NORMAL

53 58 59 60

TERMIDERR NOTAUTH

23 100

SET TRACEDEST

INVREQ

1 2 3 4

370

CICS User’s Handbook

RESP2 values
Command Condition RESP2 5 6 Meaning GTFSTATUS has an invalid CVDA value AUXPAUSE was specified, but auxiliary tracing is not active SWITCHACTION has an invalid CVDA value A SWITCH request or a SET AUXSTART request resulted in an “open” error for the trace data set There is insufficient space for a new trace table There is insufficient space for an auxiliary trace buffer There is insufficient space for a GTF trace buffer The user associated with the issuing task is not authorized to use this command SYSTEMSTATUS has an invalid CVDA value USERSTATUS has an invalid CVDA value SINGLESTATUS has an invalid CVDA value TCEXITSTATUS has an invalid CVDA value TCEXITSTATUS is specified but VTAM is not installed The user associated with the issuing task is not authorized to use this command At least one CICS component was not accessible. Trace levels were set for the other components The user associated with the issuing task is not authorized to use this command

11 IOERR 10

NOSPACE NOSTG

7 8

9 NOTAUTH 100

SET TRACEFLAG

INVREQ

1 2 3 4 5

NOTAUTH

100

SET TRACETYPE

NOTFND

1

NOTAUTH

100

Chapter 9. RESP2 values and their meanings

371

RESP2 values
Command SET TRANCLASS Condition INVREQ RESP2 2 3 Meaning The MAXACTIVE value is not in the range 0-999 The PURGETHRESH value is not in the range 0-1000000 The user associated with the issuing task is not authorized to use this command The transaction class cannot be found The dump code cannot be found ACTION has an invalid CVDA value TRANDUMPING has an invalid CVDA value SYSDUMPING has an invalid CVDA value The MAXIMUM value is out of range SHUTOPTION has an invalid CVDA value REMOVE is specified with other options The dump code is invalid DUMPSCOPE has an invalid CVDA value RELATED requires MVS/ESA 5.1 ADD is specified for a dump code already in the transaction dump table An error occurred updating the CICS catalog. The entry is changed for the current run, but is not recorded for restarts The CICS catalog is full. The entry is changed for the current run, but is not recorded for restarts The user associated with the issuing task is not authorized to use this command

NOTAUTH

100

TCIDERR

1

SET TRANDUMPCODE

NOTFND INVREQ

1 2 3 4 5 6 7 9 13 14

DUPREC

10

IOERR

11

NOSPACE

12

NOTAUTH

100

372

CICS User’s Handbook

RESP2 values
Command SET TRANSACTION Condition TRANSIDERR INVREQ RESP2 1 2 3 4 Meaning The transaction cannot be found PURGEABILITY has an invalid CVDA value STATUS has an invalid CVDA value DISABLED has been specified for a CICS-supplied transaction The TCLASS or TRANCLASS name is not known Tracing has an invalid CVDA value DUMPING has an invalid CVDA value The PRIORITY value is out of range RUNAWAYTYPE has an invalid CVDA value SHUTDOWN has an invalid CVDA value USER has been specified without a RUNAWAY value RUNAWAY has been specified without a RUNAWAYTYPE value of USER The RUNAWAY value is out of range The user associated with the issuing task is not authorized to use this command The user associated with the issuing task is not authorized to access this particular resource in the way required by this command The TSQUEUE cannot be found

5

7 8 9 10 11 12

13

14 NOTAUTH 100

101

SET NOTFND TSQUEUE/TSQNAME

1

Chapter 9. RESP2 values and their meanings

373

RESP2 values
Command Condition INVREQ RESP2 1 Meaning The TSQUEUE was not deleted because LASTUSEDINIT was greater than the interval, or because the TSQUEUE is in use The action specified was not DELETE LASTUSEDINIT was specified but has an interval value; that is, a negative value The filetype was not valid for the specified operation POOLNAME was specified but the pool could not be accessed The QUEUE name was invalid (it was binary zeroes) SYSID was specified but there was no corresponding pool, or the pool was unavailable The SYSID does not map to a shared pool I/O error on the coupling facility The user associated with the issuing task is not authorized to use this command The user associated with the issuing task is not authorized to access this particular resource in the way required by this command The UOW cannot be found UOWSTATE has an invalid CVDA value CICS is not in a valid state to COMMIT, BACKOUT, or FORCE this UOW

2 3

4 POOLERR 0

QIDERR

1

SYSIDERR

0

3 5 NOTAUTH 100

101

SET UOW

UOWNOTFOUND INVREQ

1 3 4

374

CICS User’s Handbook

RESP2 values
Command Condition NOTAUTH RESP2 100 Meaning The use of this command is not authorized The specified UOW-link cannot be found Resynchronization is already in progress, or the UOW-link is already being processed by another instance of the SET UOWLINK command The UOW is in-doubt, and the UOW-link is the coordinator of the commit or backout session. The UOW must be forced using the SET UOW command before the UOW-link can be deleted This is not a link created by a connection, or is not a recoverable link The UOW-link (and the associated communication session) is still active ACTION has an invalid CVDA value The UOW-link has a suitable connection definition, and cannot be deleted The use of this command is not authorized This command is obsolete, and is retained only for compatibility with releases of CICS earlier than CICS for MVS/ESA 5.1. It has no equivalent function in CICS for MVS/ESA 5.1 or later releases VTAM is not present in the system OPENSTATUS has an invalid CVDA value

SET UOWLINK

UOWLNOTFOUND INVREQ

1 2

3

4

5

6 7

NOTAUTH

100

SET VOLUME

VOLIDERR

1

SET VTAM

INVREQ

1 2

Chapter 9. RESP2 values and their meanings

375

RESP2 values
Command Condition RESP2 4 5 6 7 8 Meaning The PSDINTERVAL value is out of range The PSDINTHRS value is out of range The PSDINTMINS value is out of range The PSDINTSECS value is out of range A PSDINTERVAL value > 0 was specified in an XRF-eligible system VTAM reported an error while an attempt was being made to set the PSD interval A PSD interval has been specified but either the VTAM currently in use (or the VTAM library used when the terminal control table was assembled) does not support persistent sessions. The interval may have been specified earlier than this command; see the PSDINTERVAL description. If OPEN was also requested, CICS has opened the VTAM ACB The ACB has opened successfully, but an error occurred in at least one of the sessions that persisted from the previous failure Your OPEN request did not complete because another task subsequently requested a close of the VTAM connection An error occurred during recovery of sessions, and the VTAM ACB will be closed as a result

9

10

11

12

13

376

CICS User’s Handbook

RESP2 values
Command Condition RESP2 14 Meaning CICS is performing cleanup processing following a predatory XRF takeover. CICS rejects OPEN requests with this error, without invoking VTAM, during this activity. OPEN requests are processed as usual as soon as cleanup is complete Your attempt to deregister CICS from a VTAM generic resource failed because CICS is not registered as a member of a generic resource group An error occurred during the opening of the ACB. If CICS could not process the request, the RESP2 value is 3. If VTAM detects the failure, CICS returns the VTAM FDBK2 code in RESP2: you can look up these errors in the VTAM Programming manual, under ACB OPEN and CLOSE return codes The user associated with the issuing task is not authorized to use this command An invalid value has been supplied for STATUS, GARBAGEINT or TIMEOUTINT The user associated with the issuing task is not authorized to use this command No user is currently signed on There is no terminal with this task

16

IOERR

n

NOTAUTH

100

SET WEB

INVREQ

11

NOTAUTH

100

SIGNOFF

INVREQ

1 2

Chapter 9. RESP2 values and their meanings

377

RESP2 values
Command Condition RESP2 3 4 Meaning This task’s terminal has preset security Signoff is attempted using transaction routing without using the CRTE transaction The CICS ESM interface not initialized Command not allowed for a distributed program link server program A password is required The supplied password is wrong A new password is required The new password is not acceptable An OIDCARD is required The supplied OIDCARD is wrong The USERID is not authorized to use this terminal The USERID is not authorized to use the application The USERID is revoked The USERID’s access to the specified group has been revoked The signon failed during SECLABEL checking The signon failed because ESM is not currently accepting signons The GROUPID is not known to the ESM The USERID is not contained in the GROUPID The terminal already signed on No terminal associated with this task This task’s terminal has preset security

18 200

SIGNON

NOTAUTH

1 2 3 4 5 6 16

17

19 20

21 22

23 24

INVREQ

9 10 11

378

CICS User’s Handbook

RESP2 values
Command Condition RESP2 12 Meaning The response from CICS security modules is unrecognized There is an unknown return code in ESMRESP from the external security manager The required national language is not available Signon attempted via transaction routing without using the CRTE transaction The CICS ESM interface is not initialized The terminal is of an invalid type The ESM is not active The required national language is invalid The user is already signed on. This relates to the signon scope checking Command not allowed for a distributed program link server program The USERID is not known to external security manager The USERID is all blanks or nulls Unsupported language Unsupported function Subsystem interface already enabled Note: Errors 1024 and over are internal and should not occur. If one of these error codes is returned, contact your IBM support center. No subsystem present Interface being disabled; CICS is quiescing

13

14 15

18 25 27 28 29

200

USERIDERR

8

30

SPOOLCLOSE

INVREQ

4 8 40

NOSPOOL

4 8

Chapter 9. RESP2 values and their meanings

379

RESP2 values
Command Condition RESP2 12 NOTOPEN NOTFND 8 1024 Meaning Interface has been stopped Dataset has not been opened Input or output function has been corrupted, and SPOOLCLOSE could not complete Invalid CLASS value specified Unsupported language Unsupported function USERID missing INPUT|OUTPUT missing Subsystem interface already enabled Note: Errors 1024 and over are internal and should not occur. If one of these error codes is returned, contact your IBM support center. No subsystem present Interface being disabled; CICS is quiescing Interface has been stopped No data sets could be located for retrieval for the specified external writer name Input or output function has been corrupted, and SPOOLCLOSE could not complete Data set has not been opened or a task which has not issued the SPOOLOPEN for a spool data set has attempted to access it. Subtask OPEN macro failure

SPOOLOPEN INPUT

ILLOGIC INVREQ

3 4 8 16 36 40

NOSPOOL

4 8 12

NOTFND

4

1024

NOTOPEN

8

1024

380

CICS User’s Handbook

RESP2 values
Command Condition OPENERR RESP2 4 Meaning A VSAM SHOWCB macro failed to return the lengths of the VSAM control blocks used to access the JES spool file. Interface already in use by another task Interface already in use by current task Invalid CLASS value specified Unsupported language Unsupported function USERID missing NODE missing INPUT|OUTPUT missing Subsystem interface already enabled Note: Errors 1024 and over are internal and should not occur. If one of these error codes is returned contact your IBM support center. Error in the OUTDESCR string OUTDESCR specified but function not available (wrong level of MVS or JES) OUTDESCR specified but bad pointer found on keyword or in OUTDESCR condition No subsystem present Interface being disabled; CICS is quiescing Interface has been stopped No data sets could be located for retrieval for the specified external writer name Data set has not been opened

SPOLBUSY

4 8

SPOOLOPEN OUTPUT

ILLOGIC INVREQ

3 4 8 16 20 36 40

44 48

52

NOSPOOL

4 8 12

NOTFND

4

NOTOPEN

8

Chapter 9. RESP2 values and their meanings

381

RESP2 values
Command Condition RESP2 1024 OPENERR 4 Meaning Subtask OPEN macro failure A VSAM SHOWCB macro failed to return the lengths of the VSAM control blocks used to access the JES spool file. Interface already in use by another task Interface already in use by current task Invalid CLASS value specified Unsupported language Unsupported function Read attempt after end of file INTO missing Subsystem interface already enabled. Note: Errors 1024 and over are internal, and should not occur. If one of these error codes is returned, contact your IBM support center. No subsystem present Interface being disabled; CICS is quiescing Interface has been stopped No data sets could be located for retrieval for the specified external writer name Data set has not been opened Attempt to read an output file Subtask OPEN macro failure Interface already in use by another task Interface already in use by current task Unsupported language

SPOLBUSY

4 8

SPOOLREAD

ILLOGIC INVREQ

3 4 8 12 24 40

NOSPOOL

4 8 12

NOTFND

4

NOTOPEN

8 12 1024

SPOLBUSY

4 8

SPOOLWRITE

INVREQ

4

382

CICS User’s Handbook

RESP2 values
Command Condition RESP2 8 28 40 Meaning Unsupported function FROM missing Subsystem interface already enabled. Note: Errors 1024 and over are internal, and should not occur. If one of these error codes is returned, contact your IBM support center. No subsystem present Interface being disabled; CICS is quiescing Interface has been stopped Spool report has not been opened Attempt to write an input file Subtask OPEN macro failure Interface already in use by another task Interface already in use by current task Hours are out of range Minutes are out of range Seconds are out of range An attempt was made to ship a START request with the ATTACH option

NOSPOOL

4 8 12

NOTOPEN

8 16 1024

SPOLBUSY

4 8

START

INVREQ

4 5 6 11

Chapter 9. RESP2 values and their meanings

383

RESP2 values
Command Condition RESP2 12 Meaning A START request with the ATTACH option has failed Note: RESP2 values of 4, 5 and 6 are valid only if issuing AT or AFTER options. When specifying INTERVAL, only EIBRESP is passed with a value of X'10' - no RESP2 value is passed in this case A USERID was specified and the CICS external security manager interface is not initialized A resource security check has failed on TRANSID(name) A surrogate user security check has failed on USERID(name) The specified USERID is not known to the external security manager The external security manager is in a state such that CICS cannot determine whether a specified USERID is valid A file name referred to in the FILE option cannot be found in the FCT and SYSID has not been specified Browse operations are not allowed according to the file entry specification in the FCT

18

NOTAUTH

7

9

USERIDERR

8

10

STARTBR

FILENOTFOUND

1

INVREQ

20

384

CICS User’s Handbook

RESP2 values
Command Condition RESP2 25 Meaning The KEYLENGTH and GENERIC options are specified, and the length defined for the data set to which this file specified in the KEYLENGTH option is greater than or equal to the length of a full key The KEYLENGTH option is specified (but the GENERIC option is not specified), and the specified length does not equal the length defined for the data set to which this file refers An attempt has been made to start a browse with a REQID already in use for another browse The KEYLENGTH and GENERIC options are specified, and the length specified in the KEYLENGTH option is less than zero The specified file is a user-maintained data table A STARTBR command to a KSDS file that was being accessed in RLS mode specified the RBA keyword. RLS mode does not support RBA access to KSDS files File is disabled

26

33

42

44

51

DISABLED

50

Chapter 9. RESP2 values and their meanings

385

RESP2 values
Command Condition NOTOPEN RESP2 60 Meaning The requested file is CLOSED and UNENABLED or the requested file is OPEN and in use by other transactions, but a CLOSE request against it has been received or a STARTBR command was issued against a data set that is quiesced, or is being quiesced, as a result of a SET DSNAME QUIESCED or IMMQUIESCED command The remote system indicated a failure that does not correspond to a known condition An attempt to position on a record based on the search argument provided was unsuccessful A resource security check has failed on FILE(filename) A STARTBR was issued to a user-maintained data table that is currently being loaded An attempt has been made to start a browse, but a retained lock exists against the key of the first record in the range of the browse. After a LOCKED response, the browse has not been started A VSAM error has occurred which does not fall within one of the other CICS response categories There has been an I/O error during the file control operation

ISCINVREQ

70

NOTFND

80

NOTAUTH

101

LOADING

104

LOCKED

106

ILLOGIC

110

IOERR

120

386

CICS User’s Handbook

RESP2 values
Command Condition SYSIDERR RESP2 130 Meaning The SYSID option specified a name that is neither the local nor a remote system (made known to CICS by defining a CONNECTION); or the link to the remote system is closed. SYNCPOINT was in a program that is linked to from a remote system that has not specified the SYNCONRETURN option, or it was linked to locally and is defined with EXECUTIONSET=DPLSUBSET SYNCPOINT ROLLBACK was in a program that is linked to from a remote system that has not specified the SYNCONRETURN option, or it was linked to locally and is defined with EXECUTIONSET=DPLSUBSET The file name referred to in the FILE option cannot be found in the FCT and SYSID has not been specified An unlock included a token whose value cannot be matched against any token in use for an existing READ for UPDATE request A file is disabled The requested file is CLOSED and UNENABLED or the requested file is OPEN and in use by other transactions, but a close request against it has been received

SYNCPOINT

INVREQ

200

SYNCPOINT ROLLBACK

INVREQ

200

UNLOCK

FILENOTFOUND

1

INVREQ

47

DISABLED NOTOPEN

50 60

Chapter 9. RESP2 values and their meanings

387

RESP2 values
Command Condition ISCINVREQ RESP2 70 Meaning The remote system indicated a failure that does not correspond to a known condition A resource security check has failed on FILE(filename) A VSAM error has occurred which does not fall within one of the other CICS response categories There has been an I/O error during the file control operation The SYSID option specified a name that is neither the local nor a remote system (made known to CICS by defining a CONNECTION); or the link to the remote system is closed. The supplied password is wrong A new password is required The USERID is revoked The USERID is not known to the external security manager There is an unknown return code in ESMRESP from the external security manager The CICS external security manager interface is not initialized The external security manager is not responding The userid field contains a blank character in an invalid position

NOTAUTH

101

ILLOGIC (VSAM and CICS-maintained data tables) IOERR

110

120

SYSIDERR

130

VERIFY PASSWORD

NOTAUTH

2 3 19 8

USERIDERR

INVREQ

13

18

29

32

388

CICS User’s Handbook

RESP2 values
Command WAIT CONVID Condition INVREQ RESP2 200 Meaning Command not supported for distributed program link when it refers to the principal facility The ECB address is a null pointer, (X'00000000') or (X'FF000000') The specified event control area address is above the 16MB line for programs executing in 24-bit mode The event control area address is not aligned on a fullword boundary The timer-event control area specified on a WAIT EVENT is in use-key task-lifetime storage, and is inaccessible to another transaction. This condition can only occur if the storage for the timer-event control area is obtained other than by an EXEC CICS POST command, and is for posting as an ECB by some other task on completion of an event An ECB is not valid, for example the ECB is not fullword aligned An ECB is already being waited on NUMEVENTS is not a positive number PURGEABILITY is specified with an incorrect CVDA No valid ECBs have been found in the list because either the ECBLIST address is not valid or all the ECB addresses are not valid

WAIT EVENT

INVREQ

2

3

4

6

WAIT EXTERNAL

INVREQ

1

2 3 4

5

Chapter 9. RESP2 values and their meanings

389

RESP2 values
Command Condition RESP2 6 Meaning The event control blocks (ECBs) specified are in user-key task-lifetime storage, and are inaccessible to another transaction that is expected to post the ECBs or the ECBs specified are in read-only storage A distributed program link server application specified the function-shipping session (its principal facility) on the CONVID option An ECB is not valid, for example the ECB is not fullword aligned NUMEVENTS is not a positive number PURGEABILITY is specified with an incorrect CVDA No valid ECBs have been found in the list, because either the ECBLIST address is not valid, or all the ECB addresses are not valid The event control block (ECBs) specified are in user-key task-lifetime storage, and are inaccessible to another transaction that is expected to post the ECBs or the ECBs specified are in read-only storage The file name referred to in the FILE option cannot be found in the FCT

WAIT TERMINAL

INVREQ

200

WAITCICS

INVREQ

1

3 4

5

6

WRITE

FILENOTFOUND

1

390

CICS User’s Handbook

RESP2 values
Command Condition LENGERR RESP2 10 Meaning LENGTH is omitted for a WRITE to a file with variable-length records or to a BDAM file with undefined-format records The length specified for the write operation exceeds the maximum record size; the record is truncated An incorrect length is specified for a write operation involving fixed-length records Add operations are not allowed according to the file entry specification in the FCT When writing records containing embedded keys, the key in the record area (FROM option) and the key in RIDFLD do not match The KEYLENGTH option is specified, and the specified length does not equal the length defined for the data set to which this file refers to A WRITE with the MASSINSERT option has been issued against a BDAM file A BDAM key conversion error has occurred The WRITE command does not conform to the format of WRITE for a user-maintained data table

12

14

INVREQ

20

23

26

38

40 44

Chapter 9. RESP2 values and their meanings

391

RESP2 values
Command Condition RESP2 51 Meaning A WRITE command specifying the RBA keyword was issued against a KSDS file that was being accessed in RLS mode. RLS mode does not support relative byte address access to KSDS files NOSUSPEND specified but file is not RLS A file is disabled The requested file is CLOSED and UNENABLED or the requested file is OPEN and in use by other transactions, but a CLOSE request against it has been received or a WRITE request was issued against a data set that is quiesced, or is being quiesced, as a result of a SET DSNAME QUIESCED or IMMQUIESCED command The remote system indicated a failure that does not correspond to a known condition No space is available on the direct access device for adding records to a data set The maximum number of table entries specified for the user-maintained table has already been reached CICS is unable to get sufficient storage in the CICS address space to create an in-memory table entry for the record being written A resource security check has failed on FILE(filename)

55 DISABLED NOTOPEN 50 60

ISCINVREQ

70

NOSPACE

100

102

103

NOTAUTH

101

392

CICS User’s Handbook

RESP2 values
Command Condition LOADING RESP2 104 Meaning A WRITE is issued to a user-maintained data table that is currently being loaded A user exit program that is invoked at the XDTAD exit point decides not to add the record to the user-maintained data table An attempt was made to write a record, but a retained lock exists against the key of this record NOSUSPEND was specified on the request but VSAM held an active lock against the record, which would cause the request to wait A VSAM error has occurred that does not fall within one of the other CICS response categories There has been an I/O error during the file control operation or you are trying to write to a BDAM track address that is not defined for a data set The SYSID option specified a name that is neither the local nor a remote system (made known to CICS by defining a CONNECTION); or the link to the remote system is closed. An attempt has been made to add a record to a data set, by referring to a file, or a path over a file (with the UNIQUEKEY attribute), in which the same key already exists

SUPPRESSED

105

LOCKED

106

RECORDBUSY

107

ILLOGIC

110

IOERR

120

SYSIDERR

130

DUPREC

150

Chapter 9. RESP2 values and their meanings

393

RESP2 values
Command WRITE OPERATOR Condition INVREQ RESP2 1 2 3 4 5 6 EXPIRED 7 Meaning The TEXTLENGTH value is not valid The NUMROUTES value is not valid A ROUTECODE value is not valid The MAXLENGTH value is not valid The TIMEOUT value is not valid The ACTION value is not valid TIMEOUT has occurred before the operator’s reply was received The reply was longer than MAXLENGTH, and has been truncated A program has no entry in the PPT and either program autoinstall was switched off, or the program autoinstall control program indicated that the program should no be autoinstalled A program is disabled A program cannot be loaded because this was the first load of the program and the program load failed or this was a subsequent load of the program, but the first load failed In order to reset the load status the load module must be in the DFHRPL concatenation, and a SET PROGRAM NEWCOPY will be required The installed program definition is for a remote program

LENGERR

8

XCTL

PGMIDERR

1

2 3

9

394

CICS User’s Handbook

RESP2 values
Command Condition RESP2 21 Meaning The program autoinstall control program failed either because the program autoinstall control program is incorrect, incorrectly defined, or as a result of an abend in the program autoinstall control program. Program autoinstall is disabled and message DFHPG0202 or DFHPG0203 is written to the CSPL The model returned by the program autoinstall control program was not defined in the PPT table, or was not enabled The program autoinstall control program returned invalid data Define for the program failed due to autoinstall returning an invalid program name or definition An XCTL command with the INPUTMSG option was issued for a program that is not associated with a terminal, or that is associated with an APPC logical unit, or an IRC session EXEC XCTL is not allowed in a GLUE or TRUE The program manager domain has not yet been initialized An XCTL command with the INPUTMSG option has been issued in a program invoked by DPL LENGTH is less than 0 or greater than 32763

22

23

24

INVREQ

8

29

30

200

LENGERR

11

Chapter 9. RESP2 values and their meanings

395

RESP2 values
Command Condition RESP2 26 Meaning The COMMAREA address passed was zero, but LENGTH was non zero INPUTMSGLEN was less than 0 or greater than 32767 LENGTH or INPUTMSGLEN is greater than the length of the data area specified in the COMMAREA or INPUTMSG options, and while that data was being copied a destructive overlap occurred because of the incorrect length A resource security check has failed on PROGRAM(name)

27

28

NOTAUTH

101

396

CICS User’s Handbook

Chapter 10. EXEC interface block (EIB) response and function codes
This appendix lists the response codes and the function codes of EXEC CICS commands.

Response codes of EXEC CICS commands
After the execution of an EXEC CICS command, fields EIBRESP and EIBRCODE 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, no matter which command caused the condition to be raised. This is not true for EIBRCODE values: both the value and the byte of EIBRCODE in which it is set depend on which command was issued. The following sections list the conditions that are applicable to the EXEC CICS commands described in this book, their corresponding RESP values (decimal), the associated EIBRCODE values (hexadecimal), and the transaction abend codes (if any).

EXEC CICS DISCARD, INQUIRE, PERFORM, and SET commands
The first word of EIBRCODE for these commands is always set equal to the hexadecimal equivalent of the RESP value; the remaining bytes are set to X'00'.

© Copyright IBM Corp. 1989, 1999

397

Condition (Byte 3)

RESP Value code code 93 14 83 12 21 16 17 43 22 95 18 42 70 13 97 27 98 44 59 53 91 92 11 28 102 69 71

EIBRCODE

Abend

|

DSNNOTFOUND DUPREC END FILENOTFOUND ILLOGIC INVREQ IOERR JIDERR LENGERR MODELIDERR NOSPACE NOSTG NOTAUTH NOTFND PARTNERIDERR PGMIDERR PROFILEIDERR QIDERR SYSBUSY SYSIDERR TASKIDERR TCIDERR TERMIDERR TRANSIDERR UOWNOTFOUND USERIDERR VOLIDERR

5D 0E 53 0C 15 10 11 2B 16 5F 12 2A 46 0D 61 1B 62 2C 3B 35 5B 5C 0B 1C 66 45 47

AEX1 AEIN AEXK AEIL AEIU AEIP AEIQ AEYG AEIV AEX3 AEIR — AEY7 AEIM AEX5 AEI0 AEX6 AEYH — AEYQ AEXX AEX0 AEIK AEI1 AEYX AEXV

EXEC CICS DISABLE, ENABLE, and EXTRACT EXIT commands
Conditions that can be raised by the DISABLE, ENABLE, and EXTRACT EXIT commands are INVEXITREQ and NOTAUTH. There are no conditions associated with the RESYNC command.
Condition INVEXITREQ NOTAUTH RESP Value 63 70 EIBRCODE 80 46 Abend AEY0 AEY7

398

CICS User’s Handbook

Function codes of EXEC CICS commands
The function code (field EIBFN) is a hexadecimal value that identifies the command most recently issued by a task. The format of the EIBFN field is as follows: ASM COBOL PL/I C CL2 PIC X(2) CHAR (2) CHAR variable name(2);

The function codes of the commands described in this book are listed below in command sequence, then in function code sequence. For information about other function codes, see the CICS Application Programming Reference manual.
Command ACQUIRE TERMINAL COLLECT STATISTICS CREATE CONNECTION CREATE DB2CONN CREATE DB2ENTRY CREATE DB2TRAN CREATE DOCTEMPLATE CREATE ENQMODEL CREATE FILE CREATE JOURNALMODEL CREATE LSRPOOL CREATE MAPSET CREATE PARTITIONSET CREATE PARTNER CREATE PROCESSTYPE CREATE PROFILE CREATE PROGRAM CREATE REQUESTMODEL CREATE SESSIONS CREATE TCPIPSERVICE CREATE TDQUEUE CREATE TERMINAL CREATE TRANCLASS CREATE TRANSACTION CREATE TSMODEL CREATE TYPETERM DISABLE PROGRAM DISCARD AUTINSTMODEL DISCARD CONNECTION DISCARD DB2CONN DISCARD DB2ENTRY DISCARD DB2TRAN Code 86 70 30 30 30 30 30 30 30 30 30 30 30 30 30 30 30 30 30 30 30 30 30 30 30 30 22 42 58 94 94 94 02 08 0E 20 22 24 2E 2A 14 1E 16 04 06 18 26 0A 02 2C 12 30 1C 10 1A 08 28 0C 04 10 10 10 30 50

| |

|

| |

|

Chapter 10. EXEC interface block (EIB) response and function codes

399

Command
| |

Code 9E 10 90 90 4C 10 92 10 60 10 44 10 96 10 46 10 4E 10 9A 10 9C 10 5C 10 52 10 5E 18 50 10 80 30 22 02 22 06 96 12 42 02 68 12 98 02 58 02 96 14 94 02 94 22 94 42 68 22 9E 02 7A 02 66 02 90 82 96 16 7C 02 88 02 4C 02 6E 02 92 02 60 12 60 02 5A 02 70 12 52 16 52 06 44 02 96 18

|

| | |

|

|

| |

|

| | |

|

DISCARD DOCTEMPLATE DISCARD ENQMODEL DISCARD FILE DISCARD JOURNALMODEL DISCARD JOURNALNAME DISCARD PARTNER DISCARD PROCESSTYPE DISCARD PROFILE DISCARD PROGRAM DISCARD REQUESTMODEL DISCARD TCPIPSERVICE DISCARD TDQUEUE DISCARD TERMINAL DISCARD TRANCLASS DISCARD TRANSACTION DISCARD TSMODEL ENABLE PROGRAM EXTRACT EXIT INQUIRE ACTIVITYID INQUIRE AUTINSTMODEL INQUIRE AUTOINSTALL INQUIRE CFDTPOOL INQUIRE CONNECTION INQUIRE CONTAINER INQUIRE DB2CONN INQUIRE DB2ENTRY INQUIRE DB2TRAN INQUIRE DELETSHIPPED INQUIRE DOCTEMPLATE INQUIRE DSNAME INQUIRE DUMPDS INQUIRE ENQMODEL INQUIRE EVENT INQUIRE EXCI INQUIRE EXITPROGRAM INQUIRE FILE INQUIRE IRC INQUIRE JOURNALMODEL INQUIRE JOURNALNAME INQUIRE JOURNALNUM INQUIRE MODENAME INQUIRE MONITOR INQUIRE NETNAME INQUIRE NETNAME INQUIRE PARTNER INQUIRE PROCESS

400

CICS User’s Handbook

Command
|

Code 96 02 46 02 4E 02 8A 02 9A 02 3A 02 70 02 5E 08 92 12 66 22 54 02 5E 02 5E 12 9C 12 9C 02 5C 02 52 02 52 12 96 38 78 02 78 12 78 22 5E 1A 66 12 50 02 80 22 80 1A 80 12 80 02 90 02 90 62 90 22 90 42 62 02 68 02 9C 22 68 26 7E 04 58 06 72 02 64 02 76 02 70 06 16 04 68 14 58 04 94 04

| |

| |

|

| | |

|

INQUIRE PROCESSTYPE INQUIRE PROFILE INQUIRE PROGRAM INQUIRE REQID INQUIRE REQUESTMODEL INQUIRE RRMS INQUIRE STATISTICS INQUIRE STORAGE INQUIRE STREAMNAME INQUIRE SYSDUMPCODE INQUIRE SYSTEM INQUIRE TASK INQUIRE TCLASS INQUIRE TCPIP INQUIRE TCPIPSERVICE INQUIRE TDQUEUE INQUIRE TERMINAL INQUIRE TERMINAL INQUIRE TIMER INQUIRE TRACEDEST INQUIRE TRACEFLAG INQUIRE TRACETYPE INQUIRE TRANCLASS INQUIRE TRANDUMPCODE INQUIRE TRANSACTION INQUIRE TSMODEL INQUIRE TSPOOL INQUIRE TSQNAME INQUIRE TSQUEUE INQUIRE UOW INQUIRE UOWDSNFAIL INQUIRE UOWENQ INQUIRE UOWLINK INQUIRE VOLUME INQUIRE VTAM INQUIRE WEB PERFORM DELETSHIPPED PERFORM DUMP PERFORM ENDAFFINITY PERFORM RESETTIME PERFORM SECURITY PERFORM SHUTDOWN PERFORM STATISTICS RESYNC ENTRYNAME SET AUTOINSTALL SET CONNECTION SET DB2CONN

Chapter 10. EXEC interface block (EIB) response and function codes

401

Command SET SET SET SET SET SET SET SET SET SET SET SET SET SET SET SET SET SET SET SET SET SET SET SET SET SET SET SET SET SET SET SET SET SET SET SET SET SET DB2ENTRY DB2TRAN DELETSHIPPED DSNAME DUMPDS ENQMODEL FILE IRC JOURNALNAME JOURNALNUM MODENAME MONITOR NETNAME PROCESSTYPE PROGRAM STATISTICS SYSDUMPCODE SYSTEM TASK TCLASS TCPIP TCPIPSERVICE TDQUEUE TERMINAL TERMINAL TRACEDEST TRACEFLAG TRACETYPE TRANCLASS TRANDUMPCODE TRANSACTION TSQNAME TSQUEUE UOW UOWLINK VOLUME VTAM WEB

Code 94 24 94 44 68 24 7A 04 66 04 90 84 4C 04 6E 04 60 14 60 04 5A 04 70 14 52 08 96 04 4E 04 70 04 66 24 54 04 5E 04 5E 14 9C 14 9C 04 5C 04 52 04 52 14 78 04 78 14 78 24 5E 1C 66 14 50 04 80 14 80 04 90 04 90 44 62 04 68 04 9C 24

|

|

| |

| |

|

Code 16 22 22 22 30 30 04 02 04 06 0A 0C

Command RESYNC ENTRYNAME ENABLE PROGRAM DISABLE PROGRAM EXTRACT EXIT CREATE PROFILE CREATE TYPETERM

402

CICS User’s Handbook

Code 30 0E 30 02 30 04 30 06 30 08 30 1A 30 1C 30 1E 30 10 30 12 30 14 30 16 30 18 30 20 30 22 30 24 30 26 30 28 30 2A 30 2C 30 2E 30 30 3A 02 42 02 42 10 44 02 44 10 46 02 46 10 4C 02 4C 04 4C 10 4E 02 4E 04 4E 10 50 02 50 04 50 10 52 02 52 04 52 06 52 08 52 10 52 12 52 14 52 16 54 02 54 04

Command CREATE CONNECTION CREATE PROGRAM CREATE MAPSET CREATE PARTITIONSET CREATE TRANSACTION CREATE TRANCLASS CREATE TDQUEUE CREATE JOURNALMODEL CREATE TERMINAL CREATE SESSIONS CREATE FILE CREATE LSRPOOL CREATE PARTNER CREATE DB2CONN CREATE DB2ENTRY CREATE DB2TRAN CREATE PROCESSTYPE CREATE TSMODEL CREATE ENQMODEL CREATE REQUESTMODEL CREATE DOCTEMPLATE CREATE TCPIPSERVICE INQUIRE RRMS INQUIRE AUTINSTMODEL DISCARD AUTINSTMODEL INQUIRE PARTNER DISCARD PARTNER INQUIRE PROFILE DISCARD PROFILE INQUIRE FILE SET FILE DISCARD FILE INQUIRE PROGRAM SET PROGRAM DISCARD PROGRAM INQUIRE TRANSACTION SET TRANSACTION DISCARD TRANSACTION INQUIRE TERMINAL SET TERMINAL INQUIRE NETNAME SET NETNAME DISCARD TERMINAL INQUIRE TERMINAL SET TERMINAL INQUIRE NETNAME INQUIRE SYSTEM SET SYSTEM

| | | | | | |

Chapter 10. EXEC interface block (EIB) response and function codes

403

Code 58 02 58 04 58 06 58 10 5A 02 5A 04 5C 02 5C 04 5C 10 5E 02 5E 04 5E 08 5E 1A 5E 1C 5E 12 5E 14 5E 18 60 02 60 04 60 10 60 12 60 14 62 02 62 04 64 02 66 02 66 04 66 12 66 14 66 22 66 24 68 02 68 04 68 12 68 14 68 22 68 24 68 26 6E 02 6E 04 70 02 70 04 70 06 70 08 70 12 70 14 72 02 76 02

Command INQUIRE CONNECTION SET CONNECTION PERFORM ENDAFFINITY DISCARD CONNECTION INQUIRE MODENAME SET MODENAME INQUIRE TDQUEUE SET TDQUEUE DISCARD TDQUEUE INQUIRE TASK SET TASK INQUIRE STORAGE INQUIRE TRANCLASS SET TRANCLASS INQUIRE TCLASS SET TCLASS DISCARD TRANCLASS INQUIRE JOURNALNUM SET JOURNALNUM DISCARD JOURNALNAME INQUIRE JOURNALNAME SET JOURNALNAME INQUIRE VOLUME SET VOLUME PERFORM SECURITY INQUIRE DUMPDS SET DUMPDS INQUIRE TRANDUMPCODE SET TRANDUMPCODE INQUIRE SYSDUMPCODE SET SYSDUMPCODE INQUIRE VTAM SET VTAM INQUIRE AUTOINSTALL SET AUTOINSTALL INQUIRE DELETSHIPPED SET DELETSHIPPED PERFORM DELETSHIPPED INQUIRE IRC SET IRC INQUIRE STATISTICS SET STATISTICS PERFORM STATISTICS COLLECT STATISTICS INQUIRE MONITOR SET MONITOR PERFORM RESETTIME PERFORM SHUTDOWN

404

CICS User’s Handbook

Code 78 02 78 04 78 12 78 14 78 22 78 24 7A 02 7A 04 7C 02 7E 04 80 02 80 04 80 12 80 14 80 1A 80 22 80 30 86 02 88 02 8A 02 90 02 90 04 90 22 90 42 90 44 90 62 90 82 90 84 90 90 92 02 92 10 92 12 94 02 94 04 94 10 94 22 94 24 94 30 94 42 94 44 94 50 96 02 96 04 96 10 96 12 96 14 96 16 96 18

Command INQUIRE TRACEDEST SET TRACEDEST INQUIRE TRACEFLAG SET TRACEFLAG INQUIRE TRACETYPE SET TRACETYPE INQUIRE DSNAME SET DSNAME INQUIRE EXCI PERFORM DUMP INQUIRE TSQUEUE SET TSQUEUE INQUIRE TSQNAME SET TSQNAME INQUIRE TSPOOL INQUIRE TSMODEL DISCARD TSMODEL ACQUIRE TERMINAL INQUIRE EXITPROGRAM INQUIRE REQID INQUIRE UOW SET UOW INQUIRE UOWENQ INQUIRE UOWLINK SET UOWLINK INQUIRE UOWDSNFAIL INQUIRE ENQMODEL SET ENQMODEL DISCARD ENQMODEL INQUIRE JOURNALMODEL DISCARD JOURNALMODEL INQUIRE STREAMNAME INQUIRE DB2CONN SET DB2CONN DISCARD DB2CONN INQUIRE DB2ENTRY SET DB2ENTRY DISCARD DB2ENTRY INQUIRE DB2TRAN SET DB2TRAN DISCARD DB2TRAN INQUIRE PROCESSTYPE SET PROCESSTYPE DISCARD PROCESSTYPE INQUIRE ACTIVITYID INQUIRE CONTAINER INQUIRE EVENT INQUIRE PROCESS

|

| | | | | |

| | |

| | | | | | | | | | | | | | | |

Chapter 10. EXEC interface block (EIB) response and function codes

405

Abend codes
Code
| | | | | | | | | | | | |

DFH messages

Command INQUIRE TIMER INQUIRE CFDTPOOL INQUIRE REQUESTMODEL DISCARD REQUESTMODEL INQUIRE TCPIPSERVICE SET TCPIPSERVICE DISCARD TCPIPSERVICE INQUIRE TCPIP SET TCPIP INQUIRE WEB SET WEB INQUIRE DOCTEMPLATE DISCARD DOCTEMPLATE

96 38 98 02 9A 02 9A 10 9C 02 9C 04 9C 10 9C 12 9C 14 9C 22 9C 24 9E 02 9E 10

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, or request a decision. Certain CICS-supplied support programs communicate directly with terminal operators. CICS management modules and support programs log significant events and error occurrences to transient data destinations; for example, to the control system master terminal (CSMT), or to the CICS database control log (CDBC) for the CICS-DBCTL interface. The CICS message switching program (DFHMSP) generates message switching responses (described in the CICS Supplied Transactions manual). CICS directs informational macro notes (mnotes) to programmers (these are not documented). Messages produced by CICS/ESA utility programs such as DFH$MOLS and DFHMNDUP. These messages are self-explanatory and are not documented. All of the CICS messages described in this book can also be viewed online using the CICS transaction CMAC. For guidance on using CMAC, see the CICS Supplied Transactions manual.

Message Identifiers
Message identifiers are of two types.

DFHnnnn identifiers
These consist of the prefix “DFH” followed by a four digit message number. “DFH” is the IBM assigned identifier for CICS modules. The first two digits are the CICS module reference code as follows: 01 DFHSSIN 55 DFHCSDUP 42 51 DFHZCNR DFHCSDUP 56 7x DFHCSDUP Command-level translators

52 DFHCSDUP The last two digits are assigned by CICS to identify the message or group of messages within an assembled program.

© Copyright IBM Corp. 1989, 1999

407

DFH messages

DFHccnnnn identifiers
These consist of the prefix “DFH” followed by a two-letter component identifier (cc), and a four-digit message number (nnnn). The component identifier shows the domain or the component which issues the message. Here is a list of component identifiers with associated domains and components: AC The abnormal condition DX The CICS database control program component component AI The auto-install terminal model manager (AITM) EM The Event Manager domain ER The user backout program EX The external CICS interface FC The file control component FE The FE terminal test program component IC IN IR The interval control program The indoubt testing tool The interregion component

AM The RDO allocation manager AP The application domain AU The transaction affinities utility BA The Business Application Manager (BAM) domain BR Bridging to 3270 transactions CA RDO command utility routine CC The CICS catalog domain (local and global) CE The sign on program component CF CICS coupling facility data tables server CP The CPI Communications component CR The ISC remote scheduler component CZ The CICS class libraries domain DB The CICS database control component DD The directory manager DM The domain manager domain DS The dispatcher domain DU The dump domain

JC The online journal control component KC The transaction/profile manager KE The kernel domain LD The loader domain LG The logger domain LM The lock manager domain MC The BMS message control program component ME The message domain MN The monitor domain MU The message editing utility program MV The MVS RESMGR exit stub NQ The enqueue manager domain PA The parameter manager domain

408

CICS User’s Handbook

DFH messages
PC The program control program component PD The print dump exit routine DFHPDX PG The program manager domain PR The partner resource manager PS The system spooler interface control module component RD The RDO allocation manager RM The recovery Manager RP CICS ONC RPC RS The communications resynchronization program RT The ISC transaction routing component RU The recovery utility program RX The RRS-coordinated EXCI domain SH The Scheduler domain SI The system initialization component TC The terminal control program component TD The transient data component TF TI The terminal facility manager The timer domain

TM The system termination program component TO The terminal object resolution program component TP The BMS terminal page retrieval program component TR The trace domain TS The temporary storage domain UP The measured usage license charging support macro US The user domain WB The CICS Web Interface XA The XRF alternate component XC The XRF CICS availability manager XG The XRF general component XM The transaction manager XO The XRF CICS availability manager XQ The shared temporary storage queue pool server XS The CICS security component ZC The terminal control working set component ZE The TCP error message writer component

SK The sub task control program component SM The storage manager domain SN The signon component SO The CICS sockets domain SR The system recovery component ST The statistics domain SZ The front end programming interface (FEPI)

ZN The syncpoint component Thus 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 codes
Certain messages (for example, DFHDB8208D) include an action code after the message identifier. Action codes give guidance to the operator of the type of action needed when the message appears on the system console. The following action codes are used: A D E I Immediate action (for example, mount a tape) Immediate decision (reply to a request, for example, enter “GO” or “CANCEL”) Eventual – action is required, but does not have to be taken immediately No action required (If issued via the message domain, these messages can be suppressed by specifying MSGLVL=0 as a system initialization override.)

Severity codes
Certain messages, especially those associated with messages to terminal operators and messages which come from CICS utilities, have a severity code. (DFHST0210 I, is an example.) A severity code indicates to the operator whether a message is associated with an error, and if so, how serious it is. The following severity codes are used: E I W S Error. Something has gone wrong and action is required of the user before CICS processing can continue. Information only. No action is required. Warning. Something may have gone wrong, a program loop for example, but CICS processing continues. Severe error. Something serious has gone wrong and immediate action is required. CICS processing is suspended until action has been taken.

410

CICS User’s Handbook

DFH messages

Format of information
Information 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 as displayed in CICS Explanation – the events leading to or following the production of the message System action – the action that has been or will be taken by CICS User response – the action recommended for the user (the console or terminal operator or system programmer) Destination – the device or log to which the message is sent. This is one of the following: – Console – refers to a terminal type attached to CICS. (Route codes are 2 and 11 unless otherwise stated.) – Terminal end user – TERMCDBC – terminals running the CDBC transaction. – SYSPRINT (System printer) – One of the following transient data queues: CADL CAFF CAIL CCPI CDBC CDB2 CDUL CMIG CPLD CPLI CRDI CRPO CSDL CSCS CSFL CSKL CSMT CSPL VTAM resource definition log Transaction affinities utility messages Autoinstall terminal model manager (AITM) log Common programming interface for communications (CPI Communications) messages CICS-DBCTL interface log CICS DB2 messages Transaction dump messages Migration log for messages reporting the use of functions that are no longer supported PL/I dumps PL/I sysprint output Log for installed resource definitions ONC RPC messages CEDA command log Sign on/off security log File allocation and related messages Log for transaction and profile resource definitions Write term errors and abends from DFHTACP and DFHACP Log for program resource definitions

Chapter 11. DFH messages

411

DFH messages
CSQL CSRL CSSL CSTL CSML CSNE CSZL CWBO TDQUEUE messages Log for partner resource definitions Statistics log Term I/O error messages from DFHTACP Sign on/off messages Terminal error messages issued from DFHZNAC. FEPI message queue CICS Web Interface messages

Note: Destination CXRF is used by the alternate CICS system in an XRF environment until the other destinations are made available during the takeover. Module(s) – the name(s) of the module or modules that determined that the message should be sent. (This is not necessarily the module that issued the macro to write the message.)

XMEOUT parameters –
Messages that can drive the XMEOUT global user exit include a list of XMEOUT parameters. The XMEOUT exit allows you to suppress or reroute messages that use the message domain. For programming information about the XMEOUT user exit see the CICS Customization Guide

Route codes –
Console messages can be sent to a number of console types. The type of console to which a particular message is sent is determined by the MVS route code. Each route code maps onto one console type. The meanings of the route codes normally used by CICS are as follows: Code Meaning 1 Master console action – indicates a change in system status demanding operator action 2 Master console information – indicates a change in system status (system default) 3 Tape pool status or other tape related information 4 Direct access pool status or other related information 5 Tape library information 6 Disk library information 7 Unit record pool information 8 Teleprocessing control status 9 System security checking Note: This route code suppresses the operator’s reply on the screen 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 of those CICS messages that are issued via the message domain. Messages that cannot be changed using the utility include a note to this effect before the message destination. See the CICS Operations and Utilities Guide for more information about the message editing utility.

Console message reformatting –
The “console message handling facility” is an optional feature of the CICS subsystem that can affect the appearance of CICS messages displayed on an MVS console. It is effective when you specify FORMATMSG=YES as an initialization parameter for the CICS subsystem, as described in the CICS Transaction Server for OS/390 Installation Guide. When this facility is used, it affects messages displayed on MVS system consoles in the following ways: The subsystem tries to ensure that all console messages issued by all CICS regions have a standard format. The standard format is: Column number: 1 | +DFHnnnn 13 | applid 22 | message-text

The “plus” sign (+) is added by MVS to indicate that a problem-state program issued the message. It is not present when CICS issues the message 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 initialization parameter APPLID. It is the only operand when XRF=NO is also specified, or the second operand when XRF=YES is also specified. The subsystem adds routecodes specified in the ROUTECODES subsystem initialization parameter, so the messages might be sent to more console destinations than those implied in the body of this book. The subsystem reformats messages for all CICS releases, even those issued by CICS/OS/VS Version 1. The subsystem does not reformat messages that are issued by a CICS region that has not yet determined its applid. This includes messages that are issued while processing the system initialization table and its overrides.

Chapter 11. DFH messages

413

DFH messages
The subsystem routine that reformats the messages does not receive control until after the message has been recorded in the CICS job’s job log. 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 it might insert blank characters to cause alignment into standard locations. If the original CICS message is a long one, adding the applid in the standard position might cause the message to exceed the maximum length for an MVS console message. In this case, the original message is suppressed (does not appear on the console), and a new message is issued using the MVS multiple-line console message service to split the message over several lines. Both the original message and perhaps several instances of the reformatted multiple-line message appear in the job log, but only one copy of the reformatted message is displayed on the console. For some messages where the applid normally follows a time and date stamp, inserting the applid in the standard position would have resulted in the applid being duplicated within the message. For these messages, the subsystem eliminates the time and date stamp, since they are available from other sources, and only one occurrence of the applid is shown.

Terminal identifiers –
Some messages include a terminal identifier (termid) in the message text. This is normally shown as a 4-character identifier. However, when CICS cannot completely identify a terminal – for example, when intersystem communication is taking place, the terminal identifier is prefixed by the application identification (applid) of the system owning the terminal.

Abend code inserts –
The transaction abend code insert (abcode) in some CICS messages is displayed as ‘????’ when neither the EXEC CICS ABEND request nor the DFHPC TYPE=ABEND macro request specifies an abend code.

Dumps –
A dump is generally available for printing when a CICS system abend or abnormal termination occurs, provided the relevant data set has been specified. The dump can be used for problem determination.

414

CICS User’s Handbook

DFH messages

Terminology –
The terms “abnormally terminates” and “abnormal termination” are frequently used 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. (The term “abend” may also be used.) The termination of a transaction (task) as a result of a CICS transaction ABEND macro.

MVS user abend codes
DFH messages which accompany a CICS system, utility, or subtask abend have an associated MVS user abend code. Where possible, the value of this code is the numeric part of the corresponding DFH message. Thus DFH0305 has an 0305 user abend code. If an MVS abend code is issued but not the associated CICS message, the problem probably does not originate with CICS. See the description of the MVS abend code in the MVS System Codes manual for further information. The highest possible value of an MVS user abend code is 4095, therefore any DFH message with a number higher than 4095 has an MVS user abend code that does not follow the above convention. The following are lists of the abend codes for messages with numbers above 4095, in order of abend code, and in order of message number.

Ordered by abend code

Chapter 11. DFH messages

415

DFH messages
0108 0121 0123 0125 0126 0127 0147 0148 0149 0150 0151 0152 0161 0162 0170 0184 0185 0190 0191 0192 0193 0194 0195 0196 0197 0198 0200 0201 0202 0203 0204 0205 0206 0207 0209 0210 0211 0213 0214 0220 0221 0222 0223 0224 DFH5263 DFH5100 DFH5175 DFH5180 DFH5184 DFH5148 DFH5721 DFH5722 DFH5723 DFHER5724 DFHER5725 DFH5754 DFHAK5802 DFHAK5803 DFHPS5394 DFHJC4534 DFHJC4530 DFHXG6450 DFHXG6451 DFHXG6452 DFHXG6453 DFHXG6454 DFHXG6440 DFHXG6441 DFHXG6442 DFHXG6443 DFHXA6540 DFHXA6541 DFHXG6444 DFHXG6430 DFHXA6530 DFHXG6439 DFHXG6415 DFHXA6523 DFHXG6427 DFHXA6528 DFH6529 DFHXG6524 DFHXA6580 DFHXO6700 DFHXO6704 DFHXO6702 DFHXO6703 DFHXO6720

416

CICS User’s Handbook

DFH messages

Ordered by message identifier
DFHAK5802 DFHAK5803 DFHER5724 DFHER5725 DFHJC4530 DFHJC4534 DFHPS5394 DFHXA6523 DFHXA6528 DFHXA6530 DFHXA6540 DFHXA6541 DFHXA6580 DFHXG6415 DFHXG6427 DFHXG6430 DFHXG6439 DFHXG6440 DFHXG6441 DFHXG6442 DFHXG6443 DFHXG6444 DFHXG6450 DFHXG6451 DFHXG6452 DFHXG6453 DFHXG6454 DFHXG6524 DFHXO6700 DFHXO6702 DFHXO6703 DFHXO6704 DFHXO6720 DFH5100 DFH5148 DFH5175 DFH5180 DFH5184 DFH5263 DFH5721 DFH5722 DFH5723 DFH5754 DFH6529 0161 0162 0150 0151 0185 0184 0170 0207 0210 0204 0200 0201 0214 0206 0209 0203 0205 0195 0196 0197 0198 0202 0190 0191 0192 0193 0194 0213 0220 0222 0223 0221 0224 0121 0127 0123 0125 0126 0108 0147 0148 0149 0152 0211

Notes: 1. All messages which appear in the JES job log are prefixed by a time stamp and job number. Because of this, some messages will have their message text truncated. If the full message text is required, consult the MVS log as all messages in the JES log are duplicated in the MVS system log. 2. User abend 0225 is internal to CICS. It is issued by DFHDTES when, 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 abnormally terminated. If this abend occurs, you will need help to resolve the problem. See Part 4 of the CICS Problem Determination Guide for guidance 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 CSMT transient data destination containing the transaction ID, the program name and the abend code. Here is an example:

DFHAC2236 date time applid Transaction tranid abend primary abcode in program program name term termid backout successful

{ batchid = }batchid. message

Alternatively, the application can intercept abends by including an active EXEC CICS HANDLE ABEND command. The actual abend code can be determined by issuing the EXEC CICS ASSIGN command with the ABCODE option. The transaction identification code tranid usually consists of the 4 characters defined to CICS. However, when a transaction is initiated by using a light pen, an operator identification (OPID) card reader, or 3270 PA or PF keys (specified in the TASKREQ= operand), CICS creates an internal transaction identification in the form of a 1-byte 3270 attention identification (AID) code followed by 3 bytes of X'FF'. The code that may actually appear in the message in place of the internally-created transaction identification will be *xx*, where xx is the character translation of the 3270 AID code. To prevent ambiguity, the user should avoid using these codes as transaction identifiers. The keys, the light pen (LPA), and OPID, and their corresponding printed AID codes are given in the following list:
PF1 PF2 PF3 PF4 PF5 PF6 PF7 PF8 PF9 PF10 PF11 PF12 *F1* *F2* *F3* *F4* *F5* *F6* *F7* *F8* *F9* *7A* *7B* *7C* PF13 PF14 PF15 PF16 PF17 PF18 PF19 PF20 PF21 PF22 PF23 PF24 *C1* *C2* *C3* *C4* *C5* *C6* *C7* *C8* *C9* *4A* *4B* *4C* LPA OPID PA1 PA2 PA3 *7E* *E6* *6C* *6E* *6B*

© Copyright IBM Corp. 1989, 1999

419

DFH messages
An abend code indicates the cause of an error that may have been originated by CICS or by a user program. For most of the abend codes described, a CICS transaction dump is provided at abnormal termination. All CICS transaction abend codes abcode are 4-character alphanumeric codes of the form Axxy, where: Aack 'M' is the IBM-assigned designation of a CICS transaction abend.

xx y

is the 2-character code assigned by CICS to identify the module that detected an error. is the 1-character alphanumeric code assigned by CICS.

Format of information
For 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 be sent (not necessarily the module or modules that can issue the macro to write the message.)

420

CICS User’s Handbook

Abend codes

Chapter 13. Transaction abend codes
For guidance about interpreting the transaction abend codes summarized below, see the CICS Messages and Codes manual.
Abend AACA AALM AALN AALO AALP AALQ AALR AALS AALT AALU AAL1 AAL2 AAL3 AAL4 AAL6 AAL7 AAMA AAMC AAMD AAMF AAMG AAMH AAMI AAMJ Module Explanation

DFHTFP,DFHACP Invalid error code DFHAMLM Error has occurred on call to Log Manager (LM) domain DFHAMTD Error has occurred on call to the TD manager DFHAMD2 Error has occurred on call to the CICS/DB2 table manager DFHD2TM DFHAMPG Error has occurred on call to the Program Manager DFHAMBA Error has occurred on call to the Business Application Manager DFHAMBA Error has occurred on call to the Temporary Storage Manager DFHAMBA Error has occurred on call to the Global Enqueue Manager DFHAMOP Error has occurred on call to the Internet Inter-Orb Protocol Manager DFHAMSO Error has occurred on call to the Sockets Doamin Manager DFHALP DFHALP was processing a request that deadlocked DFHALP Unexpected response from suspend or resume allocated task DFHALP Task purged before GETMAIN completed DFHALP Error occurred on call to storage manager (SM) domain DFHALP Error occurred on call to SIGNOFF_TERMINAL_USER DFHALP Error occurred on call to schedule a remote terminal delete DFHAMP Internal logic error in DFHAMP DFHAMP Task purged before GETMAIN completed DFHAMP Unexpected return code from DFHDMP, internal logic error DFHAMP Unexpected return code from KE domain, internal logic error DFHAMP Unexpected return code from DFHAFMT, internal logic error DFHAMP Unexpected return code from DFHFCMT, internal logic error DFHAMP Unexpected return code from DFHFCRL, internal logic error DFHAMP Irrecoverable error from DFHFCFS while installing a file

© Copyright IBM Corp. 1989, 1999

421

Abend codes
Abend AAMK AAMN AAMO AAMP AAMQ AAMS AAMT AAMZ AAM1 AAM2 AAOA AAOB AAOC AAOD AAOE AAOF AAOG AAOH AAOI AAOJ AAOK AAOL AAOM AAON AAOO AAOP Module DFHAMP DFHAMP DFHAMP DFHAMP DFHAMP DFHAMP DFHAMP DFHAMP DFHAMP DFHAMP DFHCPI DFHCPI DFHCPARH DFHCPCBI DFHCPCBA DFHCPCBS DFHCPCBA DFHCPCOJ DFHCPCRI, DFHCPCRW DFHCPIC DFHCPIC DFHCPCLR DFHCPCLR, DFHCPSRH DFHCPCLR, DFHCPCLC DFHCPARH DFHCPCFS Explanation Irrecoverable error from DFHFCDN while installing a file Unexpected return code from DFHPRPT, internal logic error Invalid return code from DFHTOR Unexpected return code from DFHPUP, internal logic error Partner resource manager is unavailable, failed to initialize Unexpected return code from SM domain, internal logic error Unexpected return code from DFHTMP, internal logic error Unexpected return code from DFHZCP, internal logic error Unexpected response from DFHXMCL during install of TRANCLASS Unexpected response from DFHXMXD during transaction definition install Unsupported CPI verb CPI verb with more than eight parameters Invalid number of parameters for CPI Communications call Task purged before GETMAIN request to SM domain completed Task purged before GETMAIN request to SM domain completed Task purged before GETMAIN request to SM domain completed Application attached with unsupported sync level Journaling of data sent on CPI Communications mapped conversation failed Journaling of data received on CPI Communications mapped conversation failed CPI Communications detected unexpected response from internal routine CPI Communications detected unexpected call to internal routine CPI Communications made an invalid call to DFHLUC CPI Communications out of sync with DFHZUSR state machines Unexpected response from DFHLUC to CPI Communications CPI Communications invoked with invalid first parameter Impossible situation requested for CPI Communications

422

CICS User’s Handbook

Abend codes
Abend AAOQ AAOR AAOS AAOT AAOU AAOV AAOW AAOX AAOY AAOZ AAO2 AAO3 AAO4 AAO5 Module DFHCPCFS DFHCPIC DFHCPIC DFHCPCBI DFHCPCBI DFHCPCFS DFHCPCLC DFHCPIC DFHCPCRB DFHCPCRB DFHCPCBA DFHCPI DFHCPCLR DFHCPCBA, DFHCPCBI, DFHCPCBS DFHCPSRH DFHCPSRH DFHCPCLR DFHBASP DFHBASP DFHEIBAM DFHEIBAM DFHMCP, DFHMCPE, DFHM32, DFHPBP, DFHRLR DFHMCP, DFHMCPE, DFHM32, DFHPBP, DFHRLR Explanation CPI Communications return code has no entry in state table CPI Communications detected invalid value in conversation control block CPI Communications finds unexpected RESET for conversation state CPI Communications chain error in conversation control blocks CPI Communications error processing initialize conversation request CPI Communications internal state table corrupted Internal logic error in DFHCPCLC CPI Communications has detected bad syncpoint return code Invalid LL field while CPI Communications receives mapped conversation Invalid ID field while CPI Communications receives mapped conversation Unexpected response from DFHLUC to CPI Communications Call to CPI Communications without initialization Logic error detected by DFHZARL Task purged before GETMAIN completed

AAO7 AAO8 AAO9 ABAC ABAD ABAE ABAF ABLA

Invalid DFHLUC parameter list passed to CPI Communications Invalid Conversation Control Block (CPC) passed to CPI Communications Task purge detected EXEC CICS RETURN issued for activity executed with RUN command. EXEC CICS RETURN ENDACTIVITY issued for activity executedwith RUN command. EXEC CICS RETURN issued for activity executed with LINK command. EXEC CICS RETURN ENDACTIVITY issued for activity executedwith LINK command. Task purged before GETMAIN request to SM domain completed

ABLB

Error on call to SM domain

Chapter 13. Transaction abend codes

423

Abend codes
Abend ABMA ABMB Module DFHPBP, DFHMCP DFHPBP, DFHMCP DFHMCX DFHMCP DFHTPP, DFHTPR DFHTPP, DFHTPR DFHPBP DFHMCP, DFHTPQ DFHMCP, DFHMCX, DFHMCY DFHRLR DFHPBP DFHMCP, DFHMCX, DFHMCY DFHQRY DFHTPR DFHMCP, DFHEMS DFHRLR DFHPBP DFHMCP, DFHMCX, DFHMCY DFHMCP, DFHMCX, DFHMCY DFHRLR DFHMCP DFHMCP DFHMCP, DFHTPP DFHMCP, DFHTPR DFHMCP DFHPBP DFHPBP DFHPBP Explanation TIOA = 0 or < (storage accounting length - 12) Cursor position larger than current screen size

ABMC ABMD ABME ABMF ABMG ABMI

CMSG tran attempt to send to greater number of terminals than possible Unexpected return code from send DFHTPR or DFHTPP DFHTPR or DFHTPP detected invalid datastream during BMS request Send length too large BMS service not present Not input map

ABML ABMM ABMO

Terminal control locate routine received invalid data Invalid map specified Not output map

ABMQ ABMR ABMU ABMV ABMX ABMZ

Task not terminal-oriented or terminal not defined to CICS correctly CPSG initiated but task not terminal-oriented Address not within region boundaries Invalid route list entry Invalid set attribute order in text TIOA address in TCTTEDA is zero

ABM0

Map could not be located

ABM1 ABM2 ABM3 ABM4 ABM5 ABM6 ABM7 ABM8 ABM9

BMS service requested from non-BMS-supported terminal No user data for BMS request BMS service requested from a non-terminal-oriented task BMS issued invalid request response to temp storage PUT or PUTQ Purge request issued with invalid REQID by BMS CSPS not installed Trailer too large Justify parameter zero or too large for page Header or trailer too large

424

CICS User’s Handbook

Abend codes
Abend ABNA ABNB ABNC ABNE ABNF ABNG ABNH ABNI ABNJ ABNK ABRC ABRD ABRE ABRF ABRG ABRH ABRI ABRJ ABRK ABRN Module DFHTPS DFHTPS DFHTPS DFHTPS DFHTPS DFHTPS DFHTPS DFHTPS DFHTPS DFHTPS DFHBRMS, DFHBRTC DFHBRMS, DFHBRTC DFHBRMS, DFHBRTC DFHBRMS, DFHBRTC DFHBRXM DFHBRXM DFHBRXM DFHBRXM DFHBRXM DFHBRIC, DFHBRMS, DFHBRSP, DFHBRTC DFHBRMS, DFHBRTC DFHBRXM DFHBRXM DFHBRMS, DFHBRTC DFHBRIC, DFHBRMS, DFHBRSP, DFHBRTC, DFHXMBR DFHEMS DFHTBS DFH0CBRF DFH0CBRE Explanation No route list supplied Invalid TCTTE type for principal facility of the task Access temporary storage queue failed Error response from BMS ROUTE or STORE request Transaction not in send mode when sent to remote system Attach received from remote system without data Ship data to remote system failed No profile for LU6.2 transaction routing request Task purged before GETMAIN complete Error on call to storage manager domain Bridge exit not defined and could not be autoinstalled Bridge exit is disabled Bridge exit could not be loaded Bridge exit is defined as remote An invalid bridge facility token was specified The bridge facility token specified is in use by another transaction, or has been discarded There are no free bridge facility tokens available An invalid FACILITYLIKE value was specified The bridge exit returned an invalid brxa_resp value The USERID check failed following call to the bridge exit

ABRQ ABRR ABRS ABRY ABRZ

The bridge exit issued an abend The user transaction's profile could not be found CICS was unable to obtain storage to create bridge facility CICS returned an unexpected error running the bridge exit The bridge exit returned invalid data in the BRXA

ABR3 ABSA ABXA ABXC

An unsupported BMS request was received by the bridge exit A message passed to DFHBSMSG is too long CICS internal error Wrong type of RECEIVE vector in input message Error on SYNCPOINT request issued by bridge exit

Chapter 13. Transaction abend codes

425

Abend codes
Abend ABXD ABXE ABXF ABXG ABXH ABXI ABXJ ABXK ABXM ABXN ABXO ABXP ABXQ ABXS ABX1 ABX2 ABX3 ABX5 ABX6 ABX7 ABX8 ABX9 ACAA ACAD ACAI ACAJ Module DFH0CBRE Explanation

Error when SYNCPOINT ROLLBACK request issued by bridge exit DFH0CBAE,DFH0CBRE No data passed on BRDATA parameter of START command DFH0CBAE,DFH0CBRE,DFH0CBAI bridge exit inputting next message Error detected by DFH0CBAE,DFH0CBRE detected by bridge exit outputting next Error message DFH0CBRF No data available in message - transaction is non conversational DFH0CBAE,DFH0CBRE Message received by bridge exit exceeds maximum message size DFH0CBAE,DFH0CBRE exit detected error in MQCIH passed by client Bridge application DFH0CBAE,DFH0CBRE exit detected error in data passed on Bridge BRDATA parameter DFH0CBAE,DFH0CBRE,DFH0CBRF with unsupported function or Bridge exit called command DFH0CBRF Bridge exit detected input messsage was truncated DFH0CBRF Bridge exit detected error in BRMQ vector passed by client application DFH0CBRF Bridge exit detected error in BRMQ vector header passed DFH0CBRF Bridge exit could not find ADSD vector as part of BRMQ-RM vector DFH0CBRE Bridge exit detected error trying to open queue for input/output DFH0CBAE,DFH0CBRE,DFH0CBRF with invalid BRXA-HEADER Bridge exit called storage overwrite DFH0CBAE,DFH0CBRE,DFH0CBRF with invalid Bridge exit called BRXA-TRANSACTION-AREA - storage overwrite DFH0CBAE,DFH0CBRE,DFH0CBRF with unsupported Bridge exit called BRXA-COMMAND-AREA - storage overwrite DFH0CBAE,DFH0CBRE,DFH0CBRF without a user-area - error in Bridge exit called bridge exit DFH0CBAE,DFH0CBRE,DFH0CBRF with invalid user-area - storage Bridge exit called overwrite or error in bridge exit DFH0CBRF TC command passed to bridge exit exceeded maximum message size DFH0CBRF BMS BRMQ vector does not contain mapset requested DFH0CBRF Next BMS BRMQ vector does not contain mapname requested DFHCAP Parameterized resource definition contains invalid resource type code DFHCAP Parameterized resource definition contains invalid resource type code DFHCAP Invalid function code for domain call to DFHCAP DFHCAP Preallocated dynamic storage area too small

426

CICS User’s Handbook

Abend codes
Abend ACAM ACCx ACFA ACFB ACFC ACFD ACFE ACHA ACHB ACHC ACHD ACHE ACHF ACHG ACHH ACHI ACHJ ACHK ACHL ACHM ACHN ACHO ACHP ACHR ACHS ACL0 ACL1 ACL2 ACL3 Module DFHECBAM Explanation Internal Error in CBAM transaction C/370 errors. See the C/370 User's Guide for further information. Abend during loading of CFDT by CFCL transaction Request to CFDT is reliant on lock acquired before server failed Attempt to reopen access between CICS file and CFDT failed Call to CICS Txn Manager returned response and processing cannot continue Transaction not internally attached to CICS Remote server transaction is incorrect level Remote server received frame out of sequence Remote server did not receive expected acknowledgement type data frame Remote server did not receive expected response type data frame Remote server received unexpected data frame Remote server sent more than one data frame Remote server sent data when not in correct mode Remote server has no TIOA for data Remote server received unexpected return code Remote server cannot return error condition to CICS/CMS Logic error in transformer program request Remote server buffer too small Remote server response retry limit exceeded Remote server request retry limit exceeded Remote server reply retry limit exceeded Remote server reply has insufficient storage Failure of the CICS/CMS remote server transaction (CEHS) Failure of the CICS/OS2 remote server transaction (CEHP) Insufficient storage available to CICS region CICS Foundation Classes have thrown an exception - application manager failed to catch it CICS Foundation Classes invoked default handleEvent method defined in class IccResource CICS Foundation Classes responded to an application programmer's request to abend CICS task CICS Foundation Classes detected an internal error CICS Foundation Classes received an error from CICS GETMAIN CICS Foundation Classes detected an error processing storage release request

DFHFCDL DFHEIFC DFHEIFC DFHFCDL DFHFCDL DFHCHS DFHCHS DFHCHS DFHCHS DFHCHS DFHCHS DFHCHS DFHCHS DFHCHS DFHCHS DFHCHS DFHCHS DFHCHS DFHCHS DFHCHS DFHCHS DFHCHS DFHCHS ICCGLBIC ICCGLBIC ICCRESEC ICCRESIC

ACL4 ACL5 ACL6

ICCGLIBC ICCBASEC ICCBASEC

Chapter 13. Transaction abend codes

427

Abend codes
Abend ACL7 ACL8 ACL9 ACLA ACLB ACLC ACLD ACLE ACLF ACLG ACLH ACNA ACNB ACN1 ACN2 ACN3 ACN4 ACN5 ACN6 ACN7 ACN8 Module ICCGLBIC ICCGLBIC ICCRESIC ICCGLIBC ICCGLIBC ICCGLIBC ICCGLIBC ICCGLIBC ICCGLIBC ICCGLIBC ICCBASEC DFHCCNV DFHCCNV DFHCCNV DFHCCNV DFHCCNV DFHCCNV DFHCCNV DFHCCNV DFHCCNV DFHCCNV Explanation CICS Foundation Classes have thrown an exception theapplication programmer failed to catch CICS Foundation Classes have thrown an exception theapplication programmer failed to catch CICS Foundation Classes responded to a request to abenda CICS task. CICS Foundation Classes detetcted an internal error. CICS Foundation Classes detetcted an internal error. CICS Foundation Classes detetcted an internal error. CICS Foundation Classes detetcted an internal error. CICS Foundation Classes detetcted an internal error. CICS Foundation Classes detetcted an internal error. CICS Foundation Classes detetcted an internal error. CICS Foundation Classes detetcted an error whileprocessing a storage release request. Table DFHCNV could not be loaded Program DFHUCNV cannot be linked Table DFHCNV could not be loaded Table DFHCNV has wrong format in first record Program DFHUCNV could not be linked Unrecognized format of DFHCNV table encountered Override for default client code page received and unrecognized Conversion between client code page and server code page not supported by CICS/390 Override for default binary format received and unrecognized FIELD defined as having GRAPHIC characters and client code page and server code page imply FIELD contains only SBCS characters Table DFHCNV could not be loaded Bad DFHIC TYPE=GET response code Bad DFHIC TYPE=INITIATE response code Connection Quiesce Protocol txn not intended to be initiated this way Connection Quiesce Protocol txn encountered an error Connection Quiesce Protocol txn encountered an error Relay program invoked without terminal as principal facility

ACN9 ACP1 ACP2 ACQA ACQB ACQC ACRA

DFHCCNV DFHCPY DFHCPY DFHCLS5 DFHCLS5 DFHCLS5 DFHAPRT

428

CICS User’s Handbook

Abend codes
Abend ACRB ACRC ACRD ACRE ACRF ACRG ACRH ACRI ACRJ ACRK ACRL ACRM ACRO ACRP ACSA ACSB ACSC ACSD ACSE ACSF ACSG ACSH ACSI ACSJ ACSL ACSM ACSN ACTA ACTB ACTC ACTD ACTE ACTF ACTG ACTH ACTI Module DFHAPRT DFHAPRT DFHAPRT DFHAPRT DFHAPRT DFHAPRT DFHAPRT DFHAPRT, DFHEPC DFHAPRT, DFHEPC DFHAPRT DFHAPRT DFHAPRT DFHCRQ DFHAPRT DFHCRS DFHCRS DFHCRS DFHCRS DFHCRS DFHCRS DFHCRS DFHCRS DFHCRS DFHCRS DFHCRS DFHCRS DFHCRS DFHZTSP DFHZTSP DFHZTSP DFHZTSP DFHZTSP DFHZTSP DFHZTSP DFHZISP DFHCRT Explanation Relay program invoked by transaction not defined as remote Invalid response from DFHZCX System entry not found Link is out of service Dynamic routing program incorrectly initiated No matching entry in AID chain for ATI initiated remote transaction Profile could not be found Dynamic transaction routing program could not be linked Dynamic transaction routing program has abended Relay program invoked with no address for principal facility The task does not own the facility Dynamic routing program INITIAL_LINK failure Attempt to invoke CRSQ from a terminal SYDID does not support a routable start Remote scheduler task (CRSR) does not own intersystem link TCTTE Invalid reply to schedule request Unexpected request received from remote system Internal logic error detected DFHCRS attached in unsupported manner Task purged before GETMAIN to SM domain successful Error on call to SM domain Sync level mismatch for processing APPC data APPC conversion failure when attaching between systems Unexpected response on call to RM domain Unable to perform CDTS request or CFTS request Transaction CFTS has abended Transaction CFTS has stalled Relay program in TOR had unexpected request from AOR Relay program in TOR WRITE, LAST request failed Relay program in TOR failed to free session Relay program in TOR WRITE, WAIT, READ request failed Relay program in TOR failed to free session Relay program in TOR failed to free session Relay program in TOR received invalid region response Privileged allocate issued against a remote LU6.2 system TCTTE for session not owned by task

Chapter 13. Transaction abend codes

429

Abend codes
Abend ACTJ ACTK ACTL ACUA ACUB ACUC ACUD ACUE ACUF ACUG ACUH ACUI ACUJ ACUK ACUL ACUM ACUO ACUP ACUQ ACUR ACUS ACUT ACUV ACUW ACUX ACUY ACUZ ACU0 ACU1 ACU2 ACU3 ACU4 ACU5 ACU6 ACU7 ACU8 ACU9 ACVA ACVB Module DFHCRT DFHZISP DFHZISP DFHZXRL DFHZXRL DFHZXRL DFHZXRL DFHZXRL DFHZXRL DFHZXRL DFHZXRL DFHZXRL DFHZXRL DFHZXRL DFHZXRL DFHZXRL DFHZXRL DFHZXRL DFHZXRL DFHZXRL DFHZXRL DFHZXRL DFHZXRL DFHZXRL DFHZXRL DFHZXRL DFHZXRL DFHZXRL DFHZXRL DFHZXRL DFHZXRL DFHZXRL DFHZXRL DFHZXRL DFHZXRL DFHZXRL DFHZXRL DFHZXRT DFHZXRT Explanation Principal facility of relay transaction not a TCTTE Task purged before GETMAIN successful Error on call to SM domain Request not supported for transaction routing TCTSE address missing from parameter list for ALLOCATE request TCTSE address not that of a remote LU6.2 terminal Profile DFHCICSR was not located as installed profile definition Request to DFHZTSP to build surrogate TCTTE not satisfied Session not allocated, request incorrectly specified Profile for ALLOCATE not located as installed transaction definition Requested session already owned by the TCA MODENAME named in profile not found Maximum session count for modegroup is zero No TCT entry for TOR in TCTSE for remote terminal WRITE, WAIT, READ request failed Request to DFHZTSP to free surrogate TCTTE not satisfied Attempt to receive data from TOR failed Expected rollback not received Attempt to receive data from TOR failed Expected rollback not received Attempt to receive data from TOR failed Expected rollback or syncpoint not received TC ISSUE ABEND on MRO link failed TC ISSUE ERROR on MRO link failed WRITE, WAIT, READ request failed TC WRITE, WAIT failed WRITE, WAIT, READ request failed TC WRITE, LAST, WAIT failed Attempt to receive data from TOR failed Response from the TOR violates protocols AOR set of conversation state machine violates protocols Setting of conversation state machine failed Connection between two systems not installed DFHRTSU request for syncpoint failed Remote system connection not APPC or MRO connection Unexpected response and reason code from DFHRTSU Unexpected response and reason code from recovery manager TC WRITE, WAIT, or READ failed ISSUE SIGNAL on MRO link violates protocols

430

CICS User’s Handbook

Abend codes
Abend ACVC ACVD ACVE ACVF ACVG ACVH ACVK ACVL ACVM ACVN ACVO ACVP ACVQ ACVR ACWA ACXA ADCA ADCB ADCC ADCD ADCE ADCI ADCJ ADCP ADCQ ADCR ADCS ADCT ADDA Module DFHZXRT DFHZXRT DFHZXRT DFHZXRT DFHZXRT DFHZXRT DFHZXRT DFHZXRT DFHZXRT DFHZXRT DFHZXRT DFHZXRT DFHZXRT DFHZXRT DFHCWTO DFHCXCU DFHDLIDP DFHDLIDP DFHDLIDP DFHDLIDP DFHDLIDP DFHDLIDP DFHDLIDP DFHDLIDP DFHDLIDP DFHDLIDP DFHDBAT DFHDBCT DFHDBME, DFHDLI, DFHDLIDP DFHDBCON, DFHDBDSC DFHDBCON, DFHDBDI DFHDBCT DFHDBCON DFHCLS3 DFHDIP DFHDLIRP DFHDLIRP DFHDLIRP Explanation ISSUE SIGNAL on LU6.2 link failed TC READ, WAIT failed TC WRITE failed TC WRITE, LAST, WAIT failed Attempt to free session with LU6.2 terminal failed Attempt to free session with AOR failed ISSUE ABEND on LU6.2 link failed TC ISSUE ABEND on MRO link failed ISSUE ERROR on LU6.2 link failed TC ISSUE ERROR on MRO link failed ISSUE PREPARE in TOR failed or violates protocols Expected FMH43 not received from AOR Nonzero return code from APPC terminal TC SEND, LAST, WAIT failed CWTO transaction has failed, task started without a terminal ID Catch-up transaction, CXCU, has failed Nonzero return code from DBCTL No PSB scheduled for task PSB already scheduled Deadlock detected by IMS Nonzero return code from DFHDBAT User abend 3303 returned from IMS CICS-DBCTL interface terminated PSB schedule request failed security check Invalid EXEC DLI SCHD request No active communication with DBCTL Unexpected response from DBCTL to single phase commit request Attempt to invoke a CICS-DBCTL control transaction from a terminal Error on call to SM domain

ADDB ADDC ADDI ADDJ ADEF ADIR ADLE ADLF ADLG

Error on call to CC domain Error on call to LD domain CICS cannot find DBCTL alternate after failure CICS/DBCTL connect failure - DFHDBAT cannot be ENABLED Severe error executing transaction CLS3 Invalid DFHDI or DFHBMS request DL/I request for remote database on unknown system DL/I request for remote database, but link down Errors in DL/I argument list for remote database request

Chapter 13. Transaction abend codes

431

Abend codes
Abend ADLP ADMA ADMB ADMD ADPL Module DFHDLIRP DFHDBCR DFHDBCR DFHDBCR DFHEIP, DFHCPIR, DFHDLI DFHDLI DFHDXCU DFHDXCU DFHD2EX1 DFHD2EX1 DFHD2EX1 DFHD2EX1 DFHD2EX1 Explanation PSB usage failed security check Error in DBCTL connection status Unrecognizable message from CICS/XRF message manager DBCTL connection status unable to complete search for DBCTLalternate. Restricted API command used in DPL environment

ADPM ADXA ADXB AD2A AD2B AD2C AD2D AD2E

AD2F AD2G AD2H AD2I

DFHD2EX1 DFHD2EX1 DFHD2EX1 DFHD2EX1

AD2J AD2K

DFHD2EX1 DFHD2EX1

AD2L

DFHD2EX1

AD2M

DFHD2EX1

AD2N AD2O

DFHD2EX1 DFHD2EX1

CALL AIBTDLI request issued for function type not supported by CICS XRF DBCTL state catch-up transaction, DXCU, has failed XRF DBCTL state catch-up transaction, DXCU, has failed Error occurred on a LOCK call to LM domain Error occurred on an UNLOCK call to LM domain Unexpected EXCEPTION response occurred on locate call to DM domain An error occurred on locate call to DM domain to locate DB2TRAN control block Unexpected EXCEPTION response occurred on locate call to DM domain to locate a DB2ENTRY control block An error occurred on locate call to DM domain to locate a DB2ENTRY control block A transaction attempted to use a DB2ENTRY that is DISABLED or is DISABLING The CICS-DB2 attachment facility detected that a dynamic plan exit program abended The CICS-DB2 attachment facility failed to link to a dynamic plan exit program because it was not linked AMODE 31 The CICS-DB2 attachment facility failed to link to a dynamic plan exit program because it is disabled The CICS-DB2 attachment facility failed to link to a dynamic plan exit program because no program definition was found The CICS-DB2 attachment facility failed to link to a dynamic plan exit program because the program could not be loaded The CICS-DB2 attachment facility failed to link to a dynamic plan exit program because the program is defined as remote The CICS-DB2 attachment facility failed to link to a dynamic plan exit program An error occurred on an WAIT_MVS call to DM domain

432

CICS User’s Handbook

Abend codes
Abend AD2P AD2Q AD2R AD2S Module DFHD2EX1 DFHD2EX1 DFHD2EX1 DFHD2EX1 Explanation Transaction was unable to obtain a DB2 thread from a DB2ENTRY or pool An error occurred on a GETMAIN call to SM domain The CICS-DB2 subtask processing DB2 request for this transaction has abended The subtask servicing the DB2 request for transaction issued a sign-on request to DB2 which failed An attempt to create a DB2 thread failed with DB2 reason code 00F30040 An attempt to create a DB2 thread by the subtask servicing the DB2 request failed The CICS-DB2 attachment facility lost connection to DB2 (reason code 00F30805) The CICS-DB2 attachment facility received an unexpected response to single-phase commit call to DB2 The CICS-DB2 attachment facility detected that the CICS task and thread subtask were in an invalid state The transaction was unable to obtain a DB2 thread from a DB2ENTRY or or pool - no TCBs available DB2 detected a deadlock and CICS-DB2 attachment facility attempted a syncpoint rollback command for transaction The CICS-DB2 attachment facility received a request for resource manager with incorrect name The CICS-DB2 attachment facility EDF processor was unable to interpret the SQL request An error occurred on LOCK call to LM domain An error occurred on an UNLOCK call to LM domain An error occurred on LOCK call to LM domain An error occurred on an UNLOCK call to LM domain The CICS-DB2 attachment facility attempted to attach a subtask which failed due to lack of storage The CICS-DB2 attachment facility attempted to attach a subtask which failed The CICS-DB2 attachment facility was unable to link to its EDF processor DFHD2EDF An error occurred on a LOCK call to LM domain An error occurred on an UNLOCK call to LM domain Unexpected response while deleting a record from TS queue during processing of a DSNC STRT command Unexpected response from EXEC CICS GETMAIN issued during processing of a CICS-DB2 DSNC command

AD2T AD2U AD2V AD2W

DFHD2EX1 DFHD2EX1 DFHD2EX1 DFHD2EX1

AD2X

DFHD2EX1

AD2Y AD2Z

DFHD2EX1 DFHD2EX1

AD21 AD22 AD23 AD24 AD25 AD26 AD27 AD28 AD29 AD3A AD3B AD3D

DFHD2EX1 DFHD2EDF DFHD2EX2 DFHD2EX2 DFHD2CC DFHD2CC DFHD2EX1 DFHD2EX1 DFHD2EDF DFHD2STR DFHD2STR DFHD2CM1

AD3G

DFHD2CM1

Chapter 13. Transaction abend codes

433

Abend codes
Abend AD3I Module DFHD2CM1 Explanation Unexpected response from EXEC CICS INQUIRE DB2CONN issued during startup of the CICS-DB2 interface Unexpected error occurred during processing of DSNC MODIFY command Unexpected error occurred during processing of DSNC STOP command Unexpected response received reading a record frm TS queue during processing of a DSNCX STRT command Unexpected response received reading a record frm TS queue during startup of the CICS-DB2 interface Unexpected response received from EXEC CICS SET DB2CONN command during startup of the CICS-DB2 interface Transaction was unable to obtain a DB2 thread from the pool Error on locate call to transaction manager domain Unexpected response received writing a record to TS queue during startup of CICS-DB2 interface Unexpected response received writing a record to TS queue during startup of DSNC STRT command The CICS-DB2 subtask has abended because the DB2 adapter is beingshutdown. CECI, CEMT, or CEDA/B/C transaction attempted on unsupported terminal

AD3M AD3P AD3Q

DFHD2CM1 DFHD2CM1 DFHD2CM1

AD3R AD3S

DFHD2STR DFHD2CM1

AD3T AD3U AD3W AD3X AD3Z AEC1

DFHD2EX1 DFHD2EX1 DFHD2STR DFHD2CM1 DFHD2EX1 DFHECIP, DFHECSP, DFHEMTP, DFHESTP, DFHEOTP, DFHEDAP DFHECIP, DFHECSP, DFHEMTP, DFHESTP, DFHEOTP, DFHEDAP DFHAPLI DFHAPLI DFHAPLI DFHAPLI DFHAPLI DFHAPLI DFHAPLI DFHEDFX DFHEDFX

AEC2

CECI, CEMT, or CEDA/B/C tried to use too small a screen

AEC3 AEC4 AEC5 AEC6 AEC7 AEC8 AEC9 AEDA AEDB

COBOL II failed to initialize a thread COBOL II failed to initialize a run-unit C/370 failed to initialize a thread C/370 failed to initialize a run-unit Language Environment/370 failed to initialize a thread Language Environment/370 failed to initialize a run-unit Language Environment/370 had error during RUNUNIT BEGIN INITIALIZATION phase CEDF started with invalid start code DFHEDFP passed invalid EDFXA

434

CICS User’s Handbook

Abend codes
Abend AEDC AEDD AEDE AEDF AEDG AEDH AED1 Module DFHEDFX DFHEDFX DFHEDFX DFHEDFX DFHEDFX DFHEDFX DFHEDFP, DFHEDFBR DFHEDFX DFHEDFX DFHEDFP DFHEDFD DFHEDFU DFHEDFP DFHEDFX DFHEDFD DFHEIP DFHEIP DFHEIP DFHEIP DFHEIP DFHEIP DFHEIP DFHEIP DFHEIP DFHEIP DFHEIP DFHEIP DFHEIP DFHEIP DFHEIP DFHEIP DFHEIP DFHEIP DFHEIP DFHEIP DFHEIP DFHEIP DFHEIP DFHEIP DFHEIP DFHEIP DFHEIP DFHEIP DFHETL Explanation EDF GETMAIN request failed EDF attach failed EDF suspend failed User task purged before control returned to EDF User task gone away while suspended, before control returned from EDF Failure of call to Program Manager Attempt to use EDF on unsupported terminal, using CEBR on unsupported device or CEBR initiated with a non-terminal principal priority EDF has terminated a task EDF has terminated a task Internal logic error in DFHEDFP Internal logic error in EDF - insufficient dynamic storage Internal logic error in EDF TWA size too small for CEDF transaction Terminal control error in DFHEDFX Temporary storage error in EDF ERROR condition not handled EOF condition not handled EODS condition not handled INBFMH condition not handled ENDINPT condition not handled NONVAL condition not handled NOSTART condition not handled TERMIDERR condition not handled FILENOTFOUND condition not handled NOTFND condition not handled DUPREC condition not handled DEPKEY condition not handled INVREQ condition not handled IOERR condition not handled NOSPACE condition not handled NOTOPEN condition not handled ENDFILE condition not handled ILLOGIC condition not handled LENGERR condition not handled QZERO condition not handled ITEMERR condition not handled PGMIDERR condition not handled TRANSIDERR condition not handled ENDDATE condition not handled INVTSREQ condition not handled EXPIRED condition not handled TSIOERR condition not handled MAPFAIL condition not handled Function purged before control returned

AED2 AED3 AED4 AED5 AED6 AED7 AED8 AED9 AEIA AEID AEIE AEIG AEIH AEII AEIJ AEIK AEIL AEIM AEIN AEIO AEIP AEIQ AEIR AEIS AEIT AEIU AEIV AEIW AEIZ AEI0 AEI1 AEI2 AEI3 AEI4 AEI8 AEI9 AELA

Chapter 13. Transaction abend codes

435

Abend codes
Abend AELB AEMA AEMB AEMP AEMQ AETA AETC AETF AETG AETH AETI AETJ AETK AETL AETM AETN AETO AETP AETQ AETR AETS AEXC AEXF AEXG AEXI AEXJ AEXK AEXL AEXU Module DFHEGL DFHUEM DFHUEM DFHUEM DFHUEM DFHERM DFHERM DFHERM DFHERM DFHERM DFHERM DFHERM DFHERM DFHERM DFHRMSY DFHRMSY DFHRMSY DFHRMSY DFHRMSY DFHRMSY DFHRMSY DFHEIP DFHEIP DFHEIP DFHEIP DFHEIP DFHEIP DFHEIP DFHEIDTI, DFHEIQDS, DFHEIQSA, DFHEIQSC, DFHEIQSM, DFHEIQSP DFHEIQST, DFHEIQSX DFHEIP DFHEIP DFHEIP DFHxxx Explanation Function purged before control returned Error on call to AP domain Error on call to LD domain Task purged before set active request to AP domain completed Task purged before IDENTIFY_PROGRAM completed successfully Task abended by DFHERM after using DFHRMCAL macro Command issued with invalid TRUE Task purged before completion of request to SM domain Error on call to SM domain Task purged before completion of request to SM domain Error on call to SM domain Error on ADD_LINK call to RM domain Error on SET_LINK call to RM domain Error on SET_UOW call to RM domain Error on INQUIRE_TRANSACTION call to XM domain Error on INITIATE_RECOVERY call to RM domain Error on INITIATE_RECOVERY call to RM domain Error on TERMINATE_RECOVERY call to RM domain Error on INQUIRE_UOW call to RM domain Error on INQUIRE_UOW call to RM domain Error on INQUIRE_STARTUP call to RM domain RESIDERR condition not handled ESCERROR condition not handled UOWLNOTFOUND condition not handled TERMERR condition not handled ROLLEDBACK condition not handled END condition not handled DISABLED condition not handled NOTPOSS condition raised on encountering invalid parameter

AEXV AEXW AEXX AEXY

VOLIDERR condition not handled SUPPRESSED condition not handled TASKIDERR condition not handled Transaction purged before control was returned For module list, see CICS Messages and Codes

436

CICS User’s Handbook

Abend codes
Abend AEXZ Module DFHxxx Explanation Command failed due to serious failure in CICS component For module list, see CICS Messages and Codes TCIDERR condition not handled DSNNOTFOUND condition not handled LOADING condition not handled MODELIDERR condition not handled RECORDBUSY condition not handled PARTNERIDERR condition not handled PROFILEIDERR condition not handled NETNAMEIDERR condition not handled LOCKED condition not handled RECORDBUSY condition not handled INVERRTERM condition not handled INVMPSZ condition not handled IGREQID condition not handled Storage violation by CICS INVLDC condition not handled JIDERR condition not handled QIDERR condition not handled DSSTAT condition not handled SELNERR condition not handled FUNCERR condition not handled UNEXPIN condition not handled NOPASSBKRD condition not handled NOPASSBKWR condition not handled SEGIDERR condition not handled SYSIDERR condition not handled ISCINVREQ condition not handled ENVDEFERR condition not handled IGREQCD condition not handled SESSIONERR condition not handled USERIDERR condition not handled NOTALLOC condition not handled CBIDERR condition not handled INVEXITREQ condition not handled INVPARTNSET condition not handled INVPARTN condition not handled PARTNFAIL condition not handled Internal logic error in DFHUEM NOTAUTH condition not handled No DSA found on chain trying to free dynamic storage Invalid EXEC CICS command issued AMODE 24 program defined in transaction with TASKDATALOC=ANY

AEX0 AEX1 AEX2 AEX3 AEX4 AEX5 AEX6 AEX7 AEX8 AEX9 AEYA AEYB AEYC AEYD AEYE AEYG AEYH AEYJ AEYK AEYL AEYM AEYN AEYO AEYP AEYQ AEYR AEYT AEYU AEYV AEYX AEYY AEYZ AEY0 AEY1 AEY2 AEY3 AEY6 AEY7 AEY8 AEY9 AEZA

DFHEIP DFHEIP DFHEIP DFHEIP DFHEIP DFHEIP DFHEIP DFHEIP DFHEIP DFHEIP DFHEIP DFHEIP DFHEIP DFHSRP DFHEIP DFHEIP DFHEIP DFHEIP DFHEIP DFHEIP DFHEIP DFHEIP DFHEIP DFHEIP DFHEIP DFHEIP DFHEIP DFHEIP DFHEIP DFHEIP DFHEIP DFHEIP DFHEIP DFHEIP DFHEIP DFHEIP DFHUEM DFHEIP DFHEIP DFHEIP, DFHEEI DFHEIP

Chapter 13. Transaction abend codes

437

Abend codes
Abend AEZB AEZC AEZD AEZE AEZF AEZG AEZH AEZI AEZJ AEZK AEZL AEZM AEZN AEZO AEZP AEZQ AFCB AFCC AFCD AFCE AFCF AFCG AFCH AFCJ AFCK AFCL AFCM AFCN AFCO AFCR AFCS AFCT Module DFHERM DFHAPLI DFHAPLI DFHEIP DFHEIP DFHEIP DFHEIP DFHEIP DFHEIP DFHEIP DFHEIP DFHEIP DFHEIP DFHEIP DFHEIP DFHEIP DFHEIFC DFHEIFC, DFHDMPCA DFHEIFC DFHEIFC DFHEIFC, DFHDMPCA DFHEIFC, DFHDMPCA DFHEIFC DFHFCU DFHDMPCA, DFHEIFC DFHDTLX DFHDTLX DFHDMPCA, DFHEIFC DFHDTLX DFHEIFC, DFHDMPCA DFHEIFC, DFHDMPCA DFHEIFC, DFHDMPCA Explanation AMODE 24 task related user exit defined in transaction with TASKDATALOC=ANY AMODE 24 program defined in transaction with TASKDATALOC=ANY Attempt to run EXECKEY(USER) program in transaction with TASKDATAKEY(CICS) defined CHANGE condition not handled - see AEIA PROCESSBUSY condition not handled - see AEIA ACTIVITYBUSY condition not handled - see AEIA PROCESSERR condition not handled - see AEIA ACTIVITYERR condition not handled - see AEIA CONTAINERERR condition not handled - see AEIA EVENTERR condition not handled - see AEIA TOKENERR condition not handled - see AEIA NOTFINISHED condition not handled - see AEIA POOLERR condition not handled - see AEIA TIMERERR condition not handled - see AEIA SYMBOLERR condition not handled - see AEIA TEMPLATERR condition not handled - see AEIA Unexpected response from DFHFCEI resource level security check Internal logical error on calling file control request module DFHFCFR Irrecoverable error as table manager tries to locate AFCT A GETMAIN for FFLE storage failed File control deadlock between tasks File issued sequence of file control requests that would deadlock itself Request to disabled or closed table Task taking longer than DTIMEOUT interval specified for CSFU File update request issued against RLS mode data set during backup Response could not continue during loading of Shared Data Table by CSFL txn Data table load failed Journal record too large for journal buffer Transaction not internally attached by CICS on attempt to attach SMSVSAM server address space has failed SMSVSAM server address space was inactive SMSVSAM server has been recycled since an earlier request from same UOW

438

CICS User’s Handbook

Abend codes
Abend AFCU AFCV AFCW AFCY AFCZ AFC0 AFC2 AFC7 AFDA AFDB AFDC AFDD AFDE AFDF AFDG AFDH AGMA AICA AICB AICC AICD AICE AICF AICG AICH AICJ AICK AICL AICN AICO Module DFHEIFC, DFHDMPCA DFHEIFC, DFHDMPCA DFHEIFC, DFHDMPCA DFHDMPCA, DFHEIFC DFHDMPCA, DFHEIFC DFHEIFC, DFHDMPCA DFHFCU DFHDMPCA DFHFCQT DFHFCQT DFHFCQT DFHFCQT DFHFCRD DFHFCOR DFHFCOR DFHEIFC, DFHDMPCA DFHGMM DFHSRP DFHICP DFHTAJP, DFHICP DFHICP DFHICP DFHICP DFHICP DFHICP, DFHEIIC DFHICP DFHEIIC DFHEIIC DFHICP DFHICXM Explanation Data set in lost locks state Request against file in RLS mode unable to acquire record lock FC request against file in RLS mode would cause deadlock Transaction purged during file request Irrecoverable error response from DFHFCFR to its caller Updating file after file control restart failed Disastrous error from DFHFCFS on open file request Disastrous error response from DFHFCFS to DFHDMPCA Attach of transaction failed - not internally attached by CICS Transaction not CFQS or CFQR CFQS failed due to serious error CFQR failed due to serious error Attach of transaction failed - not internally attached by CICS Attach of transaction failed - not internally attached by CICS CFOR failed due to serious error VSAM RLS unable to create new locks - coupling facility full No terminal specified for Good Morning transaction Task executing for longer than runaway time interval RETRIEVE WAIT reissued in system shutdown Incorrect response from a TI domain request Incorrect response from a KE domain request Incorrect response from a DS domain request (other than AICG) Incorrect response from a TM domain request PURGED response from DS request with reason code TASK_CANCEL Task purged before request to SM domain completed successfully Error on call to SM domain Invalid response from resource level security check Invalid function code in the command level parameter list Incorrect response from US domain request Unexpected EXCEPTION response on call to US domain

Chapter 13. Transaction abend codes

439

Abend codes
Abend AICQ AICS AICT AICR AINA Module DFHDFST DFHDFST DFHDFST DFHCRR DFHINDT Explanation DFHDFST is executing at a terminal which is not permitted. DFHDFST has encountered an error during Retrieve processing. DFHDFST has encountered an error during START processing. Failure of DFHTC write request for IRC Application program failed to pass commarea containing request to be executed on LINK command Commarea passed did not contain valid request to be executed INQUIRE EXITPROGRAM failed with NOTAUTH response INQUIRE EXITPROGRAM failed with unexpected response Error on START_LINK_BROWSE commandto RM domain EXCEPTION response on GET_NEXT_LINK call to RM domain Error on GET_NEXT_LINK call to RM domain Error on END_LINK_BROWSE command to RM domain Error on INQUIRE_UOW command to RM domain Exception respone on INITIATE_RECOVERY call to RM domain Error on INITIATE_RECOVERY call to RM domain Error on SET_RECOVERY_STATUS command to RM domain Error on TERMINATE_RECOVERY command to RM domain Error on ADD_LINK command to RM domain INQUIRE TRANSACTION command failed with NOTAUTH response INQUIRE TRANSACTION command failed with unexpected response INQUIRE TASK command failed with TASKIDERR response INQUIRE TASK command failed with NOTAUTH response INQUIRE TASK command failed with unexpected response The main method within CICSMain invoked with a null COMMAREA checkbytes method within CICSCommareaMapping detected an error setbytes method within CICSCommareaMapping detected an error

AINB AINC AIND AINE AINF AING AINH AINI AINJ AINK AINL AINM AINN AINO AINP AINQ AINR AINS AIOA AIOB AIOC

DFHINDT DFHINDT, DFHINDAP DFHINDT, DFHINDAP DFHINDT DFHINDT DFHINDT DFHINDT DFHINDT DFHINDT DFHINDT DFHINDT DFHINDT DFHINTRU DFHINTRU DFHINTRU DFHINTRU DFHINTRU DFHINTRU DFJIIOP DFJIIOP DFJIIOP

440

CICS User’s Handbook

Abend codes
Abend AIOD AIOE AIOF AIOG AIOH AIOI AIOJ AIOK AIOV AIO0 AIO1 AIO2 AIO3 AIO4 AISA AISB AISC AISD AISF AISG AISH AISI AISJ AISK AISL Module DFJIIOP DFJIIOP DFJIIOP DFJIIOP DFJIIOP DFJIIOP DFJIIOP DFJIIOP DFJIIOP DFHIIOP DFHIIOPA DFHIIOP DFHIIOPA DFHIIOP DFHIIOPA DFHIIOP DFHIIOPA DFHIIOP DFHIIOPA DFHMIRS DFHMIRS DFHMIRS DFHMIRS DFHMIRS DFHMIRS DFHCRNP DFHISP DFHCRNP DFHISP DFHLUP, DFHCLS3, DFHCLS4, DFHZLS1 DFHCRNP DFHCRNP DFHMIRS Explanation setIIOPDataFromTSQ method within CICSCommareaMapping detected an error setIIOPDataFromTSQ method within CICSCommareaMapping detected an error setIIOPDataFromTSQ method within CICSCommareaMapping detected an error The main method within CICSMain failed to initialize the ORB The main method within CICSMain has received unexpected return code from ProcessMessage setBytes method within CICSCommareaMapping has detected an error writeIIOPDataToTSQ method within CICSCommareaMapping has detected an error writeIIOPDataToTSQ method within CICSCommareaMapping has detected an error setBytes method within CICSCommareaMapping has detected an error Programme chech when IIOP/CORBA call processed Call to Socket domain failed IIOP/CORBA data stream contains invalid header or data structure WRITEQ/READQ TS call detected that queue modified by another process IIOP transaction CIOF has been started incorrectly. CSMI attached to facility other than terminal Errors detected in data for mirror transaction TIOA not received from terminal by mirror transaction Mirror program received nonzero return code Facility for mirror is APPC, conversation unmapped Mirror transaction could not send reply Incorrect invocation of CSNC Invalid function shipping request from DFHEIP to DFHISP CSNC abended because LINK to DFHCRR failed Mirror transaction abended LU services manager transaction started directly from user terminal

AISN AISO AISP

CSNC failed to acquire SUSPEND TOKEN CSNC failed to suspend itself Mirror transaction invoked with invalid principal facility

Chapter 13. Transaction abend codes

441

Abend codes
Abend AISQ AISR AISS AIST AISU AISV AISW AISX AISY AISZ AIS1 AIS2 AIS3 AIS4 AIS5 AIS6 AIS7 AIS8 AIS9 AITA AITB AITC AITD AITE AITF AITG Module DFHMIRS DFHCRR DFHZARM DFHCRNP DFHMIRS DFHMIRS DFHCRSP DFHCRSP DFHLUP DFHMXP DFHCRSP DFHCRNP DFHCRNP DFHCRNP DFHCRNP DFHMIRS DFHMIRS DFHMIRS DFHMIRS DFHCRNP DFHISP DFHMIRS DFHMIRS DFHMIRS DFHMIRS DFHMIRS Explanation EXEC CICS command issued for CPI Communications session DFHCRR invoked in an incorrect manner Security violation at start of APPC conversation Unexpected return code after DFHTC TYPE=LOCATE Error on call to SM domain PURGED condition on call to SM domain to FREEMAIN Error on call to SM domain PURGED condition on call to SM domain to GETMAIN or FREEMAIN Invalid parameters for LU services manager Unexpected reply when committing START PROTECT NOCHECK requests Unexpected return code after DFHMROQM FUNC=ENQ command Unexpected return code after DFHMROQM FUNC=WAIT_Q command Failed to issue store clock instruction Unexpected return code after DFHMROQM FUNC=ENQUEUE command Unexpected return code after DFHMROQM FUNC=ENQUEUE command DISASTER, EXCEPTION, or INVALID condition on call to SM domain PURGED condition on call to SM domain Internal logic error in DFHMIRS DPL server program returned invalid state after LINK command Error on call to RM domain Error on call to RM domain Error on call to RM domain Mirror program received unexpected response from RX domain RTIMOUT interval exceeded on transactional EXCI request Transactional EXCI request purged waiting on event Transactional EXCI request executed and both a further request from the batch region and a suyncpoint initiated by RRMS occurred Invalid Resp code passed to SetAbendForCondition method Error on call to SM domain Task purged before GETMAIN request to SM domain completed Error on call to LM domain Error on call to RM domain

AJA0 AJCD AJCE AJCS AJCT

DFJCICS DFHJCP DFHJCP DFHJCP DFHJCP

442

CICS User’s Handbook

Abend codes
Abend AJCU AJ01 AJ02 AJ03 AJ04 AJ05 AJ07 AJ09 AJ99 Module DFHJCP DFJCICS DFJCICS DFJCICS DFJCICS DFJCICS DFJCICS DFJCICS DFJCICS Explanation Purge response from log manager or recovery manager Main method of jave environment setup class invoked without argument CICS AbendError caught by the java environment setup class, Wrapper CicsConditionException caught by Wrapper Unexpected condition caught by Wrapper Unhandled exception from Java application Wrapper unable to invoke the user's main method Wrapper unable to invoke the user's main method Wrapper detected AbendException and issued setAbend - abend code extracted from AbendException is too long Change directory to CICS_HOME failed Call to JVM program disallowed due to previous JVM terminationerrors JNI_CreateJavaVM request failed JVM failed to find the CICS Wrapper Class JVM failed to find the main method of the CICS Wrapper class JVM failed to build the argument list for the CICS Wrapperclass. The CICS Wrapper class threw an exception CICS JVM interface failed to set up CICS Recovery facilities. CICS JVM interface failed to delete CICS Recovery facilities. A severe error occurred whilst the JVM was executing CICS JVM interface failed to load user replaceable module DFHJVMAT. Transaction manager restart task could not complete Purge threshold on TRANCLASS reached Write to system log failed Write to catalog failed Transaction manager received an invalid request code Deadlock time-out has occurred Terminal read-time-out has occurred Unexpected return code on resume of suspended task Attempt to run CSSY as user transaction DFHKC WAIT when ECB already marked as waiting Unexpected response from DS domain call

AJMA AJMB AJM1 AJM2 AJM3 AJM4 AJM5 AJM6 AJM7 AJM8 AJM9 AKCB AKCC AKCE AKCF AKCR AKCS AKCT AKCV AKC0 AKC1 AKC2

DFHCJVM DFHAPLJ DFHCJVM DFHCJVM DFHCJVM DFHCJVM DFHCJVM DFHCJVM DFHCJVM DFHAPLJ DFHCJVM DFHKCRP DFHXMAT, DFHXMCL DFHKCQ DFHKCQ DFHXCP DFHXCP DFHXCP DFHALP DFHAPATT DFHXCP DFHXCP

Chapter 13. Transaction abend codes

443

Abend codes
Abend AKC3 Module DFHXCP, DFHXMAT, DFHXMCL, DFHXMIQ, DFHXMTA DFHXCP DFHXCP DFHXCP DFHKESTX DFHKESTX DFHKESTX, DFHKERRU DFHKEEDA DFHKERKE DFHKESGM DFHKESTX DFHKESTX DFHKETA DFH99KC DFHLGGL, DFHLGJN, DFHLGLD, DFHLGST DFHLGGL, DFHLGJN, DFHLGLD, DFHLGST DFHLGGL, DFHLGJN, DFHLGLD, DFHLGST DFHLGCM, DFHLGGL, DFHLGJN, DFHLGLD, DFHLGST DFHLGJN DFHLGGL, DFHLGJN, DFHLGST DFHLGQC DFHAPLI DFHAPLI Explanation Task has been purged

AKC6 AKC8 AKC9 AKEA AKEB AKEC AKED AKEF AKEG AKEH AKEI AKEZ AKSE ALGA

DFHKC SUSPEND did not precede DFHKC RESUME Unexpected response from call to KE domain for task purge Error from call to NQ domain Program check detected by KE domain Operating system abend detected by KE domain Runaway detected by KE domain Deferred abend request in KE domain Error detected while processing KE domain call MVS GETMAIN for kernel stack storage failed Transaction purged while running outside control of CICS. Kernel domain detected runaway while transaction isoutside control of CICS. Failure of user attach - insufficient kernel tasks No code for keyword Error obtaining lock within log manager domain

ALGB

Error releasing lock within log manager domain

ALGC

Disaster response detected processing building block code used by log manager domain

ALGD

Disaster response detected processing building block storage interface code used by log manager domain

ALGE ALGF

Unexpected error while log manager attempted to find jounal model definition Unexpected error when log manager attempted enqueue/dequeue operation Transaction CSQC issued from a terminal Insufficient storage to satisfy GETMAIN request Insufficient storage to satisfy GETMAIN request

ALGG ALIA ALIB

444

CICS User’s Handbook

Abend codes
Abend ALIC ALID ALIE ALIF ALIG AMI1 AMNA AMNB AMNZ AMSA AMSB AMSC AMSD ANQA Module DFHAPLI DFHAPLI DFHAPLI DFHAPLI DFHAPLI DFHMIRS DFHCMP DFHCMP DFHCMP DFHMSP DFHMSP DFHMSP DFHMSP DFHNQED, DFHNQIB, DFHNQNQ, DFHNQST DFHNQED, DFHNQIB, DFHNQNQ, DFHNQST DFHNQED DFHNQED DFHNQRN DFHAPLI DFHxxx DFHAPLI DFHAPLI DFHAPLI DFHAPLI DFHAPLI DFHxxx Explanation Insufficient storage to satisfy GETMAIN request Insufficient storage to satisfy GETMAIN request Insufficient storage to satisfy GETMAIN request Insufficient storage to satisfy GETMAIN request CICS unable to determine language of user application program Unexpected response when mirror task resumed Exception response from MN domain—invalid address in DATA1 Exception response from MN domain—invalid data in DATA2 Unexpected error response from MN domain SBA not followed by two 1-byte address fields Internal logic error in DFHMSP Task purged before GETMAIN to SM domain completed Error on call to SM domain Error occurred obtaining lock within enqueue domain

ANQB

Error occurred releasing lock within enqueue domain

ANQC ANQD ANQE APCF APCG APCH APCI APCJ APCK APCL APCN

APCO APCS APCT APCW

DFHAPXM DFHAPLI DFHxxx DFHAPLI

Error occurred obtaining sysplex enqueue Error occurred obtaining sysplex enqueue EXEC ENQ issued and enqmodel disabled or in waiting state Program not compiled with supported PL/I compiler Transaction purged For module list,see CICS Messages and Codes COBOL II or LE/370 support not present Execution of PL/I programs has been disabled C/370 does not recognize program Execution of C program disabled Language Environment/370 unable to determine program language Attempt to release program/mapset/partitionset that is not loaded or has already been deleted. For module list, see CICS Messages and Codes GETMAIN of storage for LEVEL 2 trace failed during transaction initialization CICS could not get run time information from LE/370 Program/mapset/partitionset failure. For module list, see CICS Messages and Codes Compiler level for COBOL program cannot be determined

Chapter 13. Transaction abend codes

445

Abend codes
Abend APCY APCZ APC0 APC1 APC2 APC3 APC4 APC5 APC6 APC7 APC8 APC9 APLx APP1 APP2 APP3 APR1 APSJ APST APSU APSV APSW APSX APSY APSZ APTI APTJ APUA APUB APUC APUD APUE Module DFHAPLI DFHAPLI DFHPCP, DFHMCY DFHAPLI DFHAPLI DFHAPLI DFHPCPC2 DFHPCPC2 DFHPCPC2 DFHPCPC2 DFHPCPC2 DFHPCPC2 Explanation Macro request from PL/I or COBOL application Program not reentrant and cannot be loaded into read-only storage Serious error on call to program manager domain Request for TGT exceeding 64KB in size Illegal branch following abend condition No Language Environment/370 support present for program Loader domain define request failed for program ILBOCOM Loader domain load request failed for program ILBOCOM An internal error has occurred An MVS IDENTIFY call for entry point ILBOCOM0 failed An MVS LOAD of ILBOCOM0 has failed An MVS LOAD of ILBOCOM has failed PL/I abend code (see OS/VS PL/I Optimizing Compiler: Programmer’s Guide) Invalid DFHIC TYPE=GET response code Data length passed to DFHP3270 less than or equal to 5 Invalid request to nonprinter Invalid DFHIC TYPE=PUT response code Spooler initialization program incorrectly invoked SPOOL command without NOHANDLE operand Invalid JES return code to spooler VSAM macro return code contains invalid value Abend in CICS system spooler subtask A CICS storage area contains invalid value Storage area for MVS macro return code contains invalid value CICS area for JES interface return code contains invalid value Task purged before GETMAIN request to SM domain completed Error on call to SM domain GETSTG parameter missing on call to DFHPUP (PUPF) GETSTG parameter missing on call to DFHPUP (PUPU) Invalid function code supplied on domain call to DFHPUP Unable to locate RDO language definition table (DFHEITSP) Lack of storage to load RDO language definition table (DFHEITSP)

DFHP3270 DFHP3270 DFHP3270 DFHPRK DFHPSIP DFHEPS DFHPSPST DFHPSPST DFHPSPST DFHPSPST DFHPSPST DFHPSPST DFHPSPST DFHPSPST DFHPUP DFHPUP DFHPUP DFHPUP DFHPUP

446

CICS User’s Handbook

Abend codes
Abend APUF APUG APUH APUI APUJ APUK APUL APUM APUN APUO APUP APUQ APUR APUS APUT APUZ APXA ARCB ARHA ARHB ARHC ARM0 ARPA ARPF ARPG ARPH ARPI ARPJ ARPK ARPL ARPM ARPN ARPO ARPU ARPV ARPW ARPX ARPZ Module DFHPUP DFHPUP DFHPUP DFHPUP DFHPUP DFHPUP DFHPUP DFHPUP DFHPUP DFHPUP DFHPUP DFHPUP DFHPUP DFHPUP DFHPUP DFHPUP DFHAPXM DFHRCEX DFHCPIR DFHCPIR DFHCPIR DFHRMXN3 DFHRTC DFHRPAS DFHRPAS DFHRPAS DFHRPAS DFHRPAS DFHRPAS DFHRPAS DFHRPAS DFHRPAS DFHRPAS DFHRPC01 DFHRPC0E DFHRPC0E DFHRPC01 DFHRPC0B Explanation RDO language definition table invalid or missing Storage cannot be obtained for CSD record buffer Storage cannot be obtained for argument list Storage cannot be freed for argument list Storage cannot be freed for CSD record buffer Unable to obtain storage Unrecognized resource type code (FLATTEN) Unrecognized resource type code (TRANCASE) Unrecognized resource type code (COMPARE) Unrecognized resource type code (BACKTRANS) Error processing language definition table for RDO Error processing language definition table for RDO Data type conflict Invalid integer data length for keyword field Invalid keyword existence bit number Invalid resource type code in CSD record User transaction's profile could not be found Initialization failure - exit program cannot be found SAA resource recovery interface has invalid first parameter Invalid number of parameters for SAA resource recovery call Unexpected return code from syncpoint program for SAA resource recovery interface Transaction not internally attached by CICS Unexpected response from DFHSUSN signing off user of CRTE transaction The alias could not be initialized The alias was not able to link to the CICS program The alias detected a global work area error The alias detected a logic error The alias ends for one of various reasons The alias detected a CICS logic error The alias detected an authorization error The alias detected an error in user code The alias detected an error while trying to switch TCBs The alias program detected an abend The connection manager could not access the CICS ONC RPC data set The connection manager received unexpected response from CICS The connection manager received unexpected response from CICS The connection manager started against an invalid terminal The connection manager has insufficient authority

Chapter 13. Transaction abend codes

447

Abend codes
Abend ARP2 ARP4 ARP5 ARP9 ARTA ARTB ARTC ARTD ARTE ARTF ARTG ARTH ARUA ARUB ARUC Module DFHRPMS DFHRPMS DFHRPMS DFHRPC01 DFHRTE DFHRTE DFHRTE DFHRTE DFHRTE DFHRTE DFHRTE DFHRTE DFHXMRU DFHXMXM DFHXMRU Explanation The server controller detected internal error during CICS ONC RPC enable processing The server controller has performed an exception disable because of an internal error An invalid attempt was made to start the server controller There was not enough storage for the connection manager Task does not own terminal as its principal facility No input TIOA, or data length zero Link not usable Internal logic error in DFHRTE Error in I/O to or from temporary storage Invalid attempt to use CRTE Profile not found Error on call to schedule remote terminal delete during sign-off Exception condition on ADD_LINK during BIND phase of ATTACH A RUN SYNCHRONOUS command caused an attempt to attach a remotely defined transaction A RUN SYNCHRONOUS command caused an attempt to attach a transaction with an invalid USERID. Error attempting to express interest in RRMS Unit of Recovery Error on ADD_LINK call to Recovery Manager domain Error on transactional EXCI request Disaster response to DFHSC TYPE=GETMAIN request from SM domain Disaster response to DFHSC TYPE=FREEMAIN request from SM domain Task purged while waiting for contiguous main storage Invalid storage control request type CESD started directly from a terminal not internally by CICS Unexpected response from EXEC CICS Attempt to execute CICS signoff without an associated terminal Attempt to execute CICS signoff program against APPC session Command failed due to a serious failure in a CICS component Command failed due to a serious failure in a CICS component

ARXA ARXB ARXC ASCA ASCB ASCP ASCR ASDA ASFA ASFB ASFC ASHA ASHB

DFHRXUW DFHRXUW DFHRXUW DFHSMSCP DFHSMSCP DFHSMSCP DFHSMSCP DFHCESD DFHSFP DFHSFP DFHSFP DFHSHDM DFHSHDM

448

CICS User’s Handbook

Abend codes
Abend ASHR ASHU ASH2 ASH3 ASH4 ASIA ASIB ASNA ASNB ASNC ASND ASOA ASPA ASPB ASPC ASPF ASPI ASPJ ASPN ASPO ASPP ASPQ ASPR ASP1 ASP2 ASP3 ASP7 ASP8 ASP9 ASQA ASQB ASQC Module DFHSHRSP DFHSHRSP DFHSHXM DFHSHRM DFHSHXM DFHSII1 DFHSIPLT DFHSNP DFHSNP DFHSNP DFHSNTU DFHSOL DFHAPAC DFHAPAC DFHSPP DFHAPAC DFHCR2U DFHCR2U DFHAPAC DFHAPAC DFHAPAC DFHAPAC DFHAPAC DFHAPAC DFHAPAC DFHAPAC DFHAPAC DFHAPAC DFHEISP DFHCRRSY DFHCRRSY DFHCRRSY Explanation Command failed due to a serious failure in a CICS component Abend occurred due to a routing failure Resources required to service request unobtainable Transaction bound to a Scheduler Services request has backed out (default abend code) Scheduler Services attempted to attatch a disabled transaction. Error on call to SM domain Invalid attempt to run CICS internal task CPLT as user transaction Unexpected response from EXEC CICS Attempt to execute CICS signon without an associated terminal Signon program failed to send request to user Request from DFHSNTU to ENQ failed during signoff terminal user TCP/IP listener task CSOL incorrectly started from a terminal Task purged before request to RM domain completed successfully Error on call to RM domain Error on call to bridge syncpoint routine (DFHBRSP) ROLLEDBACK returned to RM domain Unexpected FMH or no data received from partner system Unexpected syncpoint message data received from partner system Transaction has issued an EXEC CICS RETURN in backout required program state Intersystem session failed during syncpoint Intersystem session failed during syncpoint Intersystem communication failed during syncpoint Intersystem communication failed during syncpoint Intersystem communication failed during syncpoint Syncpoint attempted with intersystem conversation in invalid state No syncpoint taken in remote system Resource manager replied 'No' to request to 'Prepare' Syncpoint rollback not supported User Syncpoint not allowed in activation Communication session failed during CLS2 processing Logic error during CLS2 processing CLS2 transaction attached with unexpected start code

Chapter 13. Transaction abend codes

449

Abend codes
Abend ASQD ASQG ASQH ASQI ASQK ASQL ASQM ASRA ASRB ASRD ASRE ASRK ATCA ATCB ATCC ATCD ATCE ATCF ATCG ATCH Module DFHCRRSY DFHCRRSY DFHCRRSY DFHCRRSY DFHCRRSY DFHCRRSY DFHCRRSY DFHSRP DFHSRP DFHSRP DFHSRP DFHSR1 DFHZARQ DFHZARQ DFHZARQ DFHZDSP, DFHZERH DFHZARQ DFHZCRQ DFHZARQ DFHxxx Explanation CLS2 transaction could not use transaction manager for input parameters CLS2 transaction failed during receipt of data via MRO session CLS2 transaction failed during receipt of data via MRO session Attempt to invoke CICS recovery manager to save logname failed CICS internal logic error Invocation of TERMINATE_RECOVERY command to unlock data failed CICS internal logic error Program check has occurred Operating system abend Invalid macro call or reference to CSA or TCA Attempt to access a CICS-DB2 RCT load module terminated task DFHSR1 unable to call system recovery program (DFHSRP) DFHTC macro issued when in final quiesce mode Two consecutive reads or writes without intervening wait Read or more than one write issued using pipeline session CTYPE or QUEUE issued and VTAM or ZCP function not included in system DFHTC request issued without address of TIOA DFHTC CTYPE macro issued to non-VTAM TCTTE DFHTC request for terminal which program does not own Task purged before domain call completed successfully For module list,see CICS Messages and Codes Error occurred on call to DFHRTSU

ATCI

ATCJ

ATCK ATCL

ATCN

ATCO ATCQ

DFHZSUP DFHMRXM DFH62XM DFHZATA DFHZATD DFHZATR DFHZARQ DFHETL, DFHTCPCM, DFHZARQ DFHZSUP DFH62XM DFHTFXM DFHZARQ DFHZRAQ

Invalid autoinstall invocation

Write issued with CCOMPL=NO without authority Error during automatic journaling or automatic logging Error during automatic journaling or automatic logging Function unsupported by terminal or system Temporary storage error

450

CICS User’s Handbook

Abend codes
Abend ATCR ATCS ATCT Module DFHZRAR DFHZARQ DFHZSUP DFHMRXM DFH62XM DFHZARQ DFHETL, DFHZARQ, DFHZISP DFHZSUP DFHMRXM DFH62XM DFHxxx DFHZARQ, DFHZSUP DFHMRXM DFH62XM DFHZSLS DFHTCRP DFHZSLS DFHZARQ DFHTCRP DFHETL DFHETL DFHZSUP DFHETL DFHZNCE DFHETD DFHTDRP DFHTDRP DFHTOUT1 DFHTOUT1 DFHTMP DFHTMP DFHZNAC DFHZARQ, DFHZARL, DFHZSUP Explanation Temporary storage error Send data after request change direction received Build of surrogate TCTTE for remotely-owned terminal failed Send in receive mode Application attempted operation on logical unit which failed No installed profile definition for LU6.1 or APPC session Error on call to SM domain For module list,see CICS Messages and Codes Error processing inbound FMH

ATCU ATCV

ATCW

ATCX ATCY

ATCZ ATC1 ATC2 ATC3 ATC4 ATC5 ATC6 ATC7 ATC8 ATC9 ATDC ATDY ATDZ ATFE ATGE ATMA ATMB ATNA ATND

Error in call to security domain Terminal control restart task failure VTAM rejected CICS SET VTAM OPEN request Write to TLX device issued with data length of 0 causing TIOA data length (TIOATDL) to be 0 The XRF TCB abended Internal logic error in APPC mapped processing SEND DATA length greater than 65528 bytes Unexpected response from INITIAL-CALL request to DFHZARL Error during processing of an inbound FMH RESUME issued without prior SUSPEND Task purged awaiting enqueue during READQ/WRITEQ or DELETEQ command Transient data initialization failed CICS function invoked by TD init failed FREEMAIN failed during CEDA CHECK or CEDA INSTALL GETMAIN failed during CEDA CHECK or CEDA INSTALL Task purged before GETMAIN request to SM domain completed successfully Error on call to SM domain Terminal operator entered transaction identification for NACP Task termination postponed

Chapter 13. Transaction abend codes

451

Abend codes
Abend ATNI Module DFHZARL, DFHZARM, DFHZARQ, DFHZRAQ, DFHZSUP DFHCESC DFHCESC DFHCESC DFHCESC DFHCESC DFHCESC DFHCESC DFHCESC DFHCEGN DFHCEGN DFHCEGN DFHTPR DFHTPR DFHTPQ DFHTPQ DFHTPQ, DFHTPR DFHTPQ, DFHTPR DFHTRP DFHTSDQ DFHTSDQ DFHEITS, DFHICP, DFHTSP DFHEITS, DFHICP, DFHTSP DFHEITS, DFHTSP DFHEITS DFH99KO DFHUEM, DFHERM Explanation Task terminated by NEP (VTAM) or TEP (non-VTAM)

ATOA ATOB ATOC ATOD ATOE ATOF ATOG ATOH ATOT ATOU ATOV ATPA ATPB ATPC ATPD ATPE ATPF ATRA ATSA ATSB ATSC

Invalid attempt to invoke CESC with terminal as principal facility Abnormal response from EXEC CICS START TRANSACTION(CESC) Failure of a DFHZCUT timeout request Abnormal response from EXEC CICS CANCEL TRANSACTION(CESC) Cannot determine time XRF takeover began Abnormal response from EXEC CICS DELAY TRANSACTION(CESC) Abnormal response from EXEC CICS START TRANSACTION(CEGN) Failure of CESC due to an invalid function code CEGN RETRIEVE failure CEGN RETURN failure CEGN GETMAIN, ASSIGN or SEND failure Error occurred estimating the length of a CICS message Error occurred trying to retrieve a CICS message Error occurred estimating the length of a CICS message Error occurred trying to retrieve a CICS message Task purged before GETMAIN request to SM domain completed successfully Error on call to SM domain Task abnormal termination requested by DFHTRAP CTSD transaction attached other than by internal request CTSD transaction attached with invalid parameters Task canceled during temporary storage command

ATSD

Unexpected response from DS domain

ATSP ATSQ ATUF AUEL

Attempt to write to or delete a recoverable TS queue already deleted in the same unit of work Move of data to or from temporary storage failed Insufficient space to build parameter list for DYNALLOC SVC Internal logic error in CICS user exit management

452

CICS User’s Handbook

Abend codes
Abend AUEP AUXA AUXB Module DFHUEH CAUCAFB1 CAUCAFF3, CAUCAFF6, CAUCAFB1 CAUCAFB1 CAUCAFB1 CAUCAFB2, CAUCAFF3 CAUCAFB1 CAUCAFB1 CAUCAFF4, CAUCAFF5, CAUCAFB1 CAUCAFB2, CAUCAFF6 CAUCAFB2 CAUCAFF1, to CAUCAFF6, CAUCAFF7, CAUCAFB1, CAUCAFB2, CAUCAF41 CAUCAFF1, to CAUCAFF6, CAUCAFB1, CAUCAFB2 CAUCAFF1, CAUCAFF2 CAUCAFF1, CAUCAFF2 CAUCAFF1, to CAUCAFF6, CAUCAFB1 CAUCAFF3 CAUCAFF3, CAUCAFF6 CAUCAFF3 CAUCAFF3 Explanation User exit program sent return code UERCPURG to user exit handler Unexpected error when one of TAU Detector exit programs called CAUTABM The TAU Detector dataspace has filled up

AUYA AUYC AUYE AUYF AUYG AUYH

The TAU Detector transaction (CAFB) received unrecognized request The TAU Detector transaction (CAFB) received unexpected reply The TAU Detector program found an invalid affinity file number The TAU Detector transaction (CAFB) not started by CAFF The TAU Detector transaction (CAFB) still running at CICS termination The TAU Detector program found invalid address in Detector GWA The TAU Detector transaction (CAFB of CAFB) had unexpected error One of the TAU affinity data files is full Unexpected error when CAFF or CAFB issued an EXEC CICS command

AUYI AUYJ AUZA

AUZB

Unexpected error when CAFF or CAFB issued a VSAM FC EXEC CICS command

AUZC AUZD AUZF

Invalid internal field holding TAU Detector state CICS APPLID in TAU file does not match APPLID of CICS system Unexpected error when CAFF or CAFB issued a Detector user exit Unexpected error when create MVS dataspace Unexpected error when create affinity table Unexpected error when add element to table Unexpected error when internal trace table CAFF called CAUTABM to CAFF called CAUTABM to CAFF called CAUTABM to CAFF attempted to initialize

AUZH AUZI AUZJ AUZK

Chapter 13. Transaction abend codes

453

Abend codes
Abend AUZL AUZN AUZO AUZQ AUZR Module CAUCAFF4 CAUCAFF4 CAUCAFF6 CAUCAFF3 CAUCAFF4, CAUCAFF5, CAUCAFB1 CAUCAFF4 CAUCAFF1 CAUCAFF1 CAUCAFF3, CAUCAFB2 CAUCAFF3, CAUCAFF6 CAUCAFF3 DFHWBXN DFHWBBLI DFHWBENV, DFHWBTL DFHWBBLI DFHWBA DFHWBA DFHWBA DFHWBA DFHWBA DFHWBA DFHWBA DFHWBA1, DFHWBBLI DFHWBA1, DFHWBBLI DFHWBC01 DFHWBC04 Explanation Unexpected error when CAFF internal trace table Unexpected error when CAFF destroy dataspace Unexpected error when CAFF destroy table Unexpected error when CAFF MVS CPOOL storage Unexpected error when CAFF CAUCAFP to access storage attempted to release called CAUTABM to called CAUTABM to CAUCAFP to create or CAFB called

AUZS AUZU AUZV AUZY AUZZ AUZ1 AWBA AWBB AWBC AWBE AWBF AWBH AWBI AWBJ AWBK AWBL AWBM AWBQ AWBR AWBU AWBV

Unexpected error when CAFF called CAUCAFP to destroy MVS CPOOL storage Unexpected error when CAFF calculated occupancy of dataspace occupied Incorrect method of initiating TAU Detector transaction CAFF Unexpected error when CAFF or CAFB called CAUTABM to replace element Unexpected error when CAFF called subroutine to update TT or UT Header record on VSAM affinity data file not found CICS Web Receive error encountered CICS Web Business Logic Interface program parmlist error No commarea passed to CICS Web Interface utility program Converter program attempted to change response area address Web Interface alias detected an error in initialization Web Interface alias detected a logic error Web Interface alias received unexpected response from EXEC CICS ASSIGN STARTCODE Web Interface alias received unexpected response when it switched to RP TCB Web Interface alias received an abend in converter or program servicing the request *** NO DESCRIPTION FOUND *** Web Interface alias detected an error from program DFHWBBLI. Web Business Logic Interface program detected error in parameter list Web Business Logic Interface program detected a logic error Web Interface connection manager could not get storage Web Interface connection manager detected error response on EXEC CICS DEQ

454

CICS User’s Handbook

Abend codes
Abend AWBX AWBZ AWB2 AWB3 AWB4 AWB5 AWB7 AWB8 AWB9 AWC1 AWC2 AWC3 AWC4 AWC5 AWC6 AWKY AXFA AXFB AXFC AXFD AXFE AXFF AXFG AXFH AXFI AXFJ AXFL AXFM AXFO AXFP AXFQ AXFR AXFS Module DFHWBC01 DFHWBC0B DFHWBXN DFHWBXN DFHWBXN DFHWBM DFHWBENV DFHWBGB DFHWBC01 DFHWBLT DFHWBLT DFHWBLT DFHWBLT DFHWBLT DFHWBLT DFHWKP DFHXFP DFHXFP DFHXFP DFHXFP DFHXFP DFHXFP DFHXFP DFHXFP DFHXFP DFHXFP DFHXFP DFHXFP DFHXFP DFHXFP DFHXFP DFHXFP DFHXFP Explanation Web Interface connection manager started against invalid terminal type Web Interface connection manager detected NOTAUTH response to EXEC CICS EXTRACT EXIT Web Interface error in server controller attemting to disable Web Interface error trying to determine how server controller was started Web Interface server controller was invalidly started Requested port in not available Web Interface environment variables program invoked with invoking task number of zero CWBG task started directly from terminal Web Interface connection manager failed for lack of storage Bridge exit DFHWBLT could not establish partnership with Web terminal translation task Bridge exit DFHWBLT passe an invalid state token Unsupported combination of BMS and terminal control commands passed Bridge exit DFHWBLT reinvoked after returning an earlier error Bridge exit DFHWBLT could not getmain a brxa user area Bridge exit DFHWBLT detected an incinsistency in request parameters or state data Failure of global catalog request during warm keypointing File control request keylength zero Unacceptable FMH type found Invalid request passed to data transformation program Invalid request for remote system Transformation requested does not exist Unacceptable queue organization found Unacceptable argument number in data following FMH type 43 Unexpected argument in data following FMH type 43 Zero data length for WRITEQ TD or READQ TD Error code in UIBFCTR and UIBDLTR cannot be converted to SNA error code Null chain of data received ISCINVREQ condition raised Check on DS and DBA parameters failed No second FMH received FMH too short or too long Length of data exceeds 32767 Maximum length of I/O area exceeds 65535

Chapter 13. Transaction abend codes

455

Abend codes
Abend AXFT AXFU AXFW AXFX AXFY AXF0 AXF1 AXF2 AXF3 AXF4 AXF5 AXF8 AXMA Module DFHXFP DFHXFP DFHXFP DFHXFP DFHXFP DFHXFP DFHXFP DFHXFP DFHXFP DFHXFX DFHXFX DFHXFX DFHxxx Explanation Size of output I/O area exceeds 65535 Invalid two-level cursor Invalid length specification given Function shipping request by APPC link failed protocols APPC conversation failure for attach between CICS systems Task purged due to lack of storage in a DSA Unexpected return code from storage manager module DFHSMGF Task purged because of insufficient storage in DSA Unexpected return code from storage manager module DFHSMMC Task purged before GET_BUFFER request completed successfully Error on call to DFHEISR Keyword shipped to system that does not support the function Error obtaining a lock in transaction manager domain For module list,see CICS Messages and Codes Error releasing a lock in transaction manager domain For module list,see CICS Messages and Codes Severe error allocating unique transaction number to a new transaction Invalid attempt to run CICS internal task CSXM Error obtaining transaction class membership Severe error detected by the transaction manager domain Security control task could not complete Task purged before GETMAIN request to SM domain completed successfully Error on call to SM domain Calculation of data length to be shipped failed Obtain of TIOA to ship data failed Data transform failed No TIOA received from remote system Data received from remote system not long enough No relay process FMH received from remote system Data transform from remote system failed Locate of terminal identifier failed Major request byte LUCOPN0 invalid Unexpected combination of bit settings in XTSSTAT and XTSTCOPC APPC conversation failed on attach between CICS systems Wrong sync level for processing APPC mapped data

AXMB

DFHxxx

AXMC AXMD AXMY AXMZ AXSA AXSC AXSD AXTA AXTB AXTC AXTD AXTE AXTF AXTG AXTH AXTI AXTJ AXTK AXTL

DFHXMAT, DFHXMXE DFHXMAB DFHXMAT DFHXMTA DFHXSMN DFHXSMN DFHTCRP DFHXTP DFHXTP DFHXTP DFHXTP DFHXTP DFHXTP DFHXTP DFHXTP DFHXTP DFHXTP DFHXTP DFHXTP

456

CICS User’s Handbook

Abend codes
Abend AXTM AXTN AXTO AXTP AXTQ AXTR AZAB AZAD AZAE AZAF AZAG AZAH AZAI AZAJ AZAK AZCA AZCB AZCC AZCD AZCE AZCF AZCG AZCH AZCI Module DFHXTP DFHETL DFHXTP DFHXTP DFHXTP DFHXTP DFHZARM DFHZCN1 DFHZCN1 DFHZCN1 DFHZCT1 DFHZCT1 DFHZCT1 DFHZCN1 DFHZCT1 DFHZARM DFHZARM DFHZARM DFHETL, DFHZARM DFHETL, DFHZARM DFHZARM DFHZARM DFHETL, DFHZARM DFHETL, DFHZARM, DFHZARQ DFHZARM DFHZARM DFHZARM DFHZARM DFHZARM DFHZCGRP Explanation Wrong sync level for message—protected transaction Application buffer chained off TCTTE (offest TCTERCSA) has corrupted header Exception response from CICS security manager Exception response from DFHCCNV to DFHXTP Exception response from DFHCCNV to DFHXTP Exception response from DFHPGLE to DFHXTP SEND DATA length greater than 65528 DFHZCN1 started from unexpected place DFHZCN1 started from terminal facility but not LU6.2 session DFHZCN1 started for CCIN with errors DFHZCT1 started from unexpected place DFHZCT1 started from terminal facility but not LU6.2 session DFHZCT1 started for CTIN with errors CCIN must be local transaction on region directly connected to client CTIN must be local transaction on region directly connected to client DFHZARM conversation state conflict Sense code X'088901xx' received during APPC mapped processing Unsupported function management data DFHZARM invalid data length received Application data length to be received exceeds allowable limits Invalid request to DFHZARL Invalid TCTTE Unexpected sense code X'0889xxxx' received while processing APPC mapped data Invalid sync level

AZCJ AZCK AZCL AZCM AZCN AZCO

System does not support APPC structured field with null data Internal logic error in error recovery for APPC mapped processing Sense code X'088901xx' received during APPC mapped processing Error on call to SM domain Task purged before GETMAIN request to SM domain completed successfully VTAM persistent sessions initialization txn (CGRP) started directly from terminal

Chapter 13. Transaction abend codes

457

Abend codes
Abend AZCP AZCQ Module DFHZSUP DFH62XM DFHZSUP DFHMRXM DFH62XM DFHZARL DFHZARQ DFHZCOVR DFHZCOVR DFHZCSTP DFHZIS2 DFHZIS2 DFHZIS2 DFHZIS2 DFHZARQ DFHZARQ DFHZARQ DFHZARQ DFHZARQ DFHZARQ DFHZARQ DFHZARQ DFHZIS2 DFHZIS1 DFHZIS2 DFHZARRC DFHZARR0 DFHZARR0 DFHZARR0 DFHZARRF DFHZARR DFHZARR DFHZARR1 DFHZARR0 DFHZARRF DFHZARRF Explanation Logic error in ZCP Error on call to RM domain

AZCR AZCT AZCU AZCV AZCW AZIA AZIB AZIC AZID AZIE AZIF AZI1 AZI2 AZI3 AZI4 AZI5 AZI6 AZI7 AZI8 AZI9 AZRA AZRB AZRD AZRE AZRF AZRG AZRH AZRI AZRJ AZRK AZRL

Error during APPC SYNCPOINT ROLLBACK request Terminal read-time-out has occurred Invalid attempt to start COVR transaction Logic error in COVR transaction while connecting to VTAM Invalid attempt to run CICS internal task CSTP Transaction request for storage during MRO processing invalid Transaction purged while waiting for storage Error on call to SM domain to FREEMAIN PURGED condition on call to SM domain to FREEMAIN IRC ISSUE-ERROR or ISSUE-ABEND violated IRC protocols Error on call to RM domain IRC data transmission protocol violated IRC data transmission cannot complete Conversation failed IRC link to connected transaction down IRC data transmission violated IRC protocols IRC connected transaction abnormally terminated Wait during MRO request rejected by CICS dispatcher Incorrect format for error log data Failing transaction purged during wait FMH address missing from APPC receive buffer First parameter is invalid in call to DFHZARR0 APPC logical and physical receive buffers are out of step Logical APPC receive buffer starts outside physical buffer Invalid state error returned from DFHZUSR state machine Invalid state error returned from DFHZUSR state machine Invalid RECEIVE_TYPE in DFHZARR Invalid parameter passed to DFHZARR1 APPC record length exceeds receive buffer Invalid combination of fields in DFHLUC parameter list First parameter invalid in call to DFHZARRF

458

CICS User’s Handbook

Abend codes
Abend AZRM AZRN AZRO AZRP AZRQ AZRR AZRS AZRT AZRU AZRV AZRW AZRY AZRZ AZR2 AZR3 AZR4 AZR5 AZR6 AZS0 AZS1 AZS2 AZS3 AZS4 AZS5 AZS6 AZTA AZTB AZTC AZTF AZTG AZTH AZTI AZTL AZTM AZTN AZTO AZTP AZTQ AZTR AZTS AZTT Module DFHZARR DFHZARRF DFHZARER DFHZARER DFHZARRA DFHZARRA DFHZARRA DFHZARRA DFHZARRF DFHZARR1 DFHZARRA DFHZARR DFHZARR DFHZARRA DFHZARRA DFHZARER DFHZARR1 DFHZARER DFHZSTAP DFHZSTAP DFHZSTAP DFHZSTAP DFHZSTAP DFHZSTAP DFHZSTAP DFHZTSP DFHZTSP DFHZTSP DFHZTSP DFHZTSP DFHZTSP DFHZTSP DFHZTSP DFHZTSP DFHZTSP DFHZTSP DFHZTSP DFHZTSP DFHZTSP DFHZTSP DFHZTSP Explanation DFHZARR called one of its own routines at wrong time DFHLUC parameter list does not have LUCCIERR set on First parameter invalid in call to DFHZARER Invalid response from DFHZNAC Invalid parameter in call to DFHZARRA Corrupted header in application buffer DFHZARRA cannot acquire main memory Invalid application buffer Unexpected response from DFHZARR0 Unexpected response from DFHZARR0 Negative record length in the TCTTE Unexpected response from DFHZARRC Unexpected response from an internal subroutine DFHZARRA can not acquire main memory Task purged during GETMAIN request Unexpected response from dispatcher domain call Unexpected response from dispatcher domain call Exception condition from APPC routine DFHZARL to RM domain DFHZSTAM macro passed invalid request No TCTTE pointer passed via DFHZSTAM macro TCTTE passed via DFHZSTAM does not relate to MRO or APPC conversation No LUCX found for an APPC TCTTE DFHZUSRM LUC State Machine has invalid setting Internal State number has invalid setting Internal State number has invalid setting Task does not own terminal as principal facility Attempt to delete/install remote terminal failed Failure of remote terminal install or delete caused by SOS condition TCTTE length error due to storage violation, or CICS logic error Principal facility not intersystem TCTTE Error response from remote terminal control macro Terminal not defined as remotely owned Request to invalid terminal Data has no FMH Conversation unexpectedly terminated TCTTE ownership chain in error BMS TYPE=STORE request failed Invalid BMS data received from remote system BMS TYPE=PAGEOUT request failed Data ship to remote system failed Connection with remote system not APPC or MRO connection

Chapter 13. Transaction abend codes

459

Abend codes
Abend AZTU AZTV AZTW AZTY AZTZ AZT1 AZT3 AZT6 AZT7 AZT8 AZT9 Module DFHZTSP DFHZTSP DFHZTSP DFHZTSP DFHZTSP DFHZTSP DFHZTSP DFHZTSP DFHZTSP DFHZTSP DFHZTSP Explanation Link TCTTE not owned by task after syncpoint Invalid FMH received from remote system Attach request to task already running Maximum APPC sessions limit reached Relay program DFHCRT attached in unsupported manner Task attached improperly in AOR when transaction routing Task is being routed back to region from where it came TOR has violated transaction routing protocol TCT entry for remotely owned APPC terminal can not be added to TCT TCT entry for remotely owned APPC terminal can not be deleted from TCT TCT entry for remotely owned APPC terminal can not be deleted from TCT as it is locked by another task Time-out while waiting for service transaction CITS to complete DFHZCQ failed to create remote terminal definition Unexpected error in DFHZATS Unexpected error in install procedure of DFHZATS Terminal has same ID as an existing TCT entry An attempt was made to start CITS/CDTS/CMTS/CFTS from a terminal Error in remote delete routines Error in remote delete routine while processing mass delete Error in remote delete routine while processing single delete Error in mass deletion of remote terminals Unexpected return code during deletion of single terminal Error in mass flag routine of remote terminals for deletion Error in DFHZATMF CRMF started directly from terminal CRMD started directly from terminal Error in DFHZATMD Request to install a shipped terminal definition rejected by autoinstall user program Unexpected return code from autoinstall user program Error in autoinstall user program Autoinstall of shipped terminal, virtual terminal or shipped connection failed

AZVA AZVB AZVC AZVD AZVE AZVF AZVG AZVH AZVI AZVJ AZVK AZVL AZVM AZVN AZVO AZVP AZVQ AZVR AZVS AZVU

DFHZATS DFHZATS DFHZATS DFHZATS DFHZATS DFHZATS DFHZATS DFHZATS DFHZATS DFHZATS DFHZATS DFHZATS DFHZATMF DFHZATMF DFHZATMD DFHZATMD DFHZATS DFHZATS DFHZATS DFHZATS

460

CICS User’s Handbook

Abend codes
Abend AZXA AZXB DHxx 0100 Module DFHZXCU DFHZXCU DFH***** DFHEAP DFHECP DFHEDP DFHEPP DFHEAP DFHECP DFHEDP DFHEPP DFHPD DFHPDX DFHPD DFHPDX DFHCSDUP DFHCSDUP DFHCSDUP DFHCSDUP DFHCSDUP DFHCSDUP DFHCSDUP DFHCSDUP DFHCSDUP DFHCSDUP DFHCSDUP DFHCSDUP DFHCSDUP DFHCSDUP DFHCSDUP DFHCSDUP DFHCSDUP DFHCSDUP DFHCSDUP DFHXCSTB DFHXCPRH DFHXCPRH DFHXCPRH DFHXCPRH DFHXCPRH DFHXCPRH Explanation Catch-up program finds unexpected error, reason code 5 Catch-up program finds unexpected error, reason code 4 EXEC DL/I error or invalid status code (xx) Translator error opening listing data set

0101

Translator program check

0211 0212 0300 0301 0302 0303 0304 0305 0307 0308 0309 0321 0322 0323 0325 0326 0327 0328 0330 0331 0332 0401 0402 0403 0404 0405 0406 0407

Recursive program check in system dump Too many program checks in system dump SYSIN data set failed to open successfully Invalid RECFM in SYSIN DD statement Invalid record length in SYSIN DD statement SYSPRINT data set has not opened successfully DFHCSDUP found unrecognized resource type code in CSD record Unexpected return code received Attempt to print input command failed Bad command sequence found migrating TCT table Unrecognized function code found in command Internal error in DFHCSDUP module Table to be migrated could not be loaded VSAM detected an error processing a command Error occurred during execution of DFHDMP function Internal logic error in DFHCSDUP utility program Language table DFHEITCU could not be loaded Language table DFHEITCU could not be unloaded Cross-reference table size too small *** NO DESCRIPTION FOUND *** *** NO DESCRIPTION FOUND *** EXCI call made in AMODE 24 Nonzero return code following MVS ESTAE issued by DFHXCPRH Nonzero return code following MVS GETMAIN request by DFHXCPRH EXCI dump services not available to take MVS SDUMP Failure of SSI VERIFY request by DFHXCPRH Failure of CICS SVC call during EXCI initialization CICS SVC at the wrong level for EXCI

Chapter 13. Transaction abend codes

461

Abend codes
Abend 0408 0409 0410 0411 0412 0413 0414 0415 0501 Module DFHXCPRH DFHXCPRH DFHXCPRH DFHXCDMP DFHXCEIP DFHXCEIP DFHXCEIP DFHXCEIP DFHCALLA, DFHMSGIF, DFHTRCIF DFHAPLJ Explanation Failure of MVS GETMAIN request by DFHXCPRH for working storage Failure of MVS GETMAIN request by DFHXCPRH for SSI VERIFY Failure of MVS GETMAIN request by DFHXCPRH for XCUSER block Failure of CICS SVC call by DFHXCDMP Invalid function in EXEC parameter list of EXCI EXEC API request Error in EXEC parameter list of EXCI EXEC API request Nonzero return code following MVS ESTAE issued by DFHXCEIP Error in EXCI initialization detected by DFHXCEIP JCICS request attempted on a pthread

0555

CICS JVM interface percolation abend to drive LanguageEnvironment 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 II applications running on CICS. The last three digits of the abend code, xxx, correspond to the xxx in the associated COBOL II run-time message, IGZxxxI. COBOL II run-time messages are described in the VS COBOL II Application Program Debugging Guide, SC26-4049.

© Copyright IBM Corp. 1989, 1999

463

464

CICS User’s Handbook

VTAM

Chapter 15. VTAM-associated errors
This section lists the terminal error codes from VTAM.

VTAM terminal error codes and CICS message numbers
Terminal error codes from VTAM are put in a one-byte field of the DFHZNAC COMMAREA (DFHNEPCA) at label TWAEC. For those error codes that have CICS messages associated with them, you should see the CICS Messages and Codes for descriptions of the corresponding error conditions.
CICS message DFHZC0101 DFHZC0125 DFHZC0131 DFHZC0144 DFHZC0145 DFHZC0146 DFHZC0147 DFHZC0148 DFHZC0149 DFHZC0150 DFHZC0155 DFHZC0156 DFHZC2102 DFHZC2117 DFHZC2351 DFHZC2400 DFHZC2401 DFHZC2402 DFHZC2403 DFHZC2404 DFHZC2404 DFHZC2404 DFHZC2405 DFHZC2406 DFHZC2407 Action flags set Error code X'5D' X'FB' X'FC' X'7A' X'79' X'FD' X'71' X'72' X'FF' X'FE' X'6C' X'6D' X'E9' X'DB' X'6F' X'C1' X'B1' X'B4' X'11' X'E6' X'14' X'18' X'10' X'19' X'15' Symbolic label TCZPRDTO TCZPSUNB TCZPSOPN TCZPSRAC TCZPSRAF TCZPSRC TCZPSLE TCZPSVF TCZPSPE TCZPSRF TCZPSAF TCZPSAR TCZSTIND TCZPIPL TCZSDAS TCZSRCAT TCZRPLAC TCZRSNE TCZSRCBF TCZDMLG TCZLRCER TCZLRCNR TCZSRCTU TCZSRCTS TCZSRCPF

11 3 9 10 11 24 DUMPNTA 3 9 10 11 24 DUMPNTA 9 10 11 24 3 9 10 11 15 24 DUMPNTA 3 9 10 11 24 DUMPNTA 3 9 10 11 23 24 23 2 3 9 10 11 24 AOS 2 3 9 10 11 24 OUTSERV 3 11 2 5 18 24 2 3 9 10 11 24 AOS 2 3 9 10 11 24 AOS 18 9 10 11 18 2 3 9 10 11 24

© Copyright IBM Corp. 1989, 1999

465

VTAM
CICS message DFHZC2408 DFHZC2408 DFHZC2409 DFHZC2410 DFHZC2411 DFHZC2412 DFHZC2413 DFHZC2414 DFHZC2416 DFHZC2417 DFHZC2417 DFHZC2418 DFHZC2419 DFHZC2420 DFHZC2421 DFHZC2422 DFHZC2423 DFHZC2424 DFHZC2425 DFHZC2426 DFHZC2427 DFHZC2428 DFHZC2429 DFHZC2430 DFHZC2431 DFHZC2432 DFHZC2433 DFHZC2434 DFHZC2435 DFHZC2436 DFHZC2437 DFHZC2438 DFHZC2439 DFHZC2440 DFHZC2441 DFHZC2442 DFHZC2443 DFHZC2444 DFHZC2445 Action flags set 23 24 23 24 23 24 23 24 9 10 11 18 9 10 11 18 9 10 11 15 9 10 11 18 Error code X'1A' X'1E' X'D0' X'D1' X'E0' X'E1' X'E2' X'80' X'13' X'1D' X'20' X'BB' X'82' X'B5' X'60' X'90' X'74' X'75' X'B2' X'94' X'C5' X'92' X'91' X'78' X'CB' X'81' X'E4' X'43' X'96' X'97' X'73' X'A1' X'98' X'D7' X'D6' X'DC' X'59' X'A3' X'95' Symbolic label TCZSRCVE TCZSRCV2 TCZTXCS TCZTXCU TCZDMSN TCZDMRA TCZDMCL TCZSRCSP TCZSRCVH TCZSRCVI TCZVTAMI TCZSEXUC TCZSSXUC TCZSAXUC TCZUNCMD TCZLGCER TCZSDSE5 TCZSESE1 TCZSDAUC TCZRACES TCZSRCNA TCZSDSE6 TCZRSTLE TCZSDRE2 TCZSRCTC TCZSSXNR TCZAIER TCZCPYNS TCZRVSZ1 TCZRVSZ3 TCZSDSE4 TCZRVSZ2 TCZACT01 TCZSXC1 TCZSXC2 TCZPXE1 TCZROCT TCZBKTSE TCZSDSE8

2 18 24 2 24 2 3 9 10 11 24 AOS 2 3 9 10 11 24 AOS 2 3 9 10 11 24 AOS 2 3 9 10 11 24 1 2 3 9 10 11 DUMPNTA 3 9 10 11 24 3 9 10 11 15 24 3 9 10 11 15 24 2 3 9 10 11 22 2 3 9 11 3 10 11 3 9 11 RESP 2 3 9 10 11

3 3 3 3 3 2

11 10 11 24 10 11 9 11 10 11 18

2 3 9 10 11 24 2 3 9 10 11 24 3 9 11

466

CICS User’s Handbook

VTAM
CICS message DFHZC2446 DFHZC2447 DFHZC2448 DFHZC2449 DFHZC2450 DFHZC2451 DFHZC2452 DFHZC2453 DFHZC2454 DFHZC2455 DFHZC2456 DFHZC2457 DFHZC2458 DFHZC2459 DFHZC2463 DFHZC2467 DFHZC2468 DFHZC2469 DFHZC2469 DFHZC2470 DFHZC2471 DFHZC2472 DFHZC2473 DFHZC2485 DFHZC2486 DFHZC2487 DFHZC2488 DFHZC2489 DFHZC2490 DFHZC2497 DFHZC2498 DFHZC3400 DFHZC3402 DFHZC3409 DFHZC3410 DFHZC3416 DFHZC3417 DFHZC3418 DFHZC3419 DFHZC3420 DFHZC3421 Action flags set 2 3 9 10 11 24 AOS 3 9 10 11 AOS 2 3 10 11 24 AOS RESP 2 3 11 18 22 24 23 39 12 23 23 23 24 23 9 10 11 10 11 18 24 3 9 10 9 10 11 9 10 11 9 10 11 18 9 10 11 24 Error code X'84' X'9A' X'65' X'A7' X'83' X'CC' X'D5' X'D4' X'CD' X'93' X'44' X'D8' X'DD' X'99' X'D3' X'88' X'89' X'D9' X'F2' X'DA' X'A8' X'A9' X'AA' X'E3' X'9B' X'76' X'77' X'40' X'41' X'42' X'4B' X'45' X'46' X'85' X'BC' X'E8' X'50' X'51' X'52' X'53' X'5A' Symbolic label TCZSSXIB TCZDOMCF TCZINVRR TCZBOEB TCZSSXAR TCZSRCCI TCZCXE2 TCZCXRR TCZSRCCX TCZRACET TCZSRCDE TCZRNCH TCZPXE2 TCZSDSE7 TCZDMPD TCZLEXCI TCZLEXUS TCZYX43 TCZEXRVT TCZSXC3 TCZFMHLE TCZRACRF TCZSDSE9 TCZCNCL TCZRACNL TCZLGNA TCZDMRY TCZINCPY TCZTOLRQ TCZUNPRT TCZICPUT TCZCHMX TCZOCIR TCZUNEGR TCZINIIR TCZDMSLE TCZSDRE3 TCZBDPRI TCZBDUAC TCZBDTOS TCZSBIRV

3 9 11 2 3 9 10 11 24 AOS 2 3 9 10 11 24 2 3 9 10 11 2 3 9 10 11 9 10 11 24 2 3 10 11 22 24 PRTTIOA 11 3 9 11 3 9 10 11 3 3 3 9 11 2 3 9 10 11 15 24

3 10 11 RESP 3 9 10 11 2 3 9 10 11 24 AOS 2 3 9 10 11 23 3 9 10 11 24 3 9 10 11 24 235 20 20

Chapter 15. VTAM-associated errors

467

VTAM
CICS message DFHZC3422 DFHZC3424 DFHZC3428 DFHZC3429 DFHZC3430 DFHZC3431 DFHZC3432 DFHZC3433 DFHZC3434 DFHZC3440 DFHZC3441 DFHZC3442 DFHZC3443 DFHZC3444 DFHZC3452 DFHZC3454 DFHZC3455 DFHZC3461 DFHZC3462 DFHZC3463 DFHZC3464 DFHZC3465 DFHZC3466 DFHZC3468 DFHZC3469 DFHZC3470 DFHZC3470 DFHZC3471 DFHZC3472 DFHZC3473 DFHZC3474 DFHZC3475 DFHZC3476 DFHZC3477 DFHZC3479 DFHZC3480 DFHZC3481 DFHZC3482 DFHZC3484 DFHZC3485 DFHZC3486 DFHZC3487 DFHZC3488 DFHZC3489 Action flags set 2 3 9 10 11 18 24 9 10 11 15 24 3 23 23 23 23 2 3 9 10 11 24 Error code X'5B' X'5C' X'EB' X'EC' X'ED' X'EF' X'EA' X'58' X'54' X'55' X'63' X'67' X'64' X'6A' X'66' X'5E' X'5F' X'48' X'49' X'4A' X'57' X'9D' X'69' X'70' X'CE' X'AB' X'37' X'CF' X'9E' X'4D' X'AC' X'AD' X'AE' X'AF' X'4E' X'A0' X'4C' X'DF' X'C6' X'C7' X'C2' X'C9' X'3C' X'C8' Symbolic label TCZNSP01 TCZNSP02 TCZSTRMH TCZSTRMM TCZSTON TCZSTIN TCZSTLER TCZERMGR TCZUNBIS TCZEMWBK TCZVTAMO TCZVTAMK TCZVTAMA TCZTIOAE TCZSIGR TCZBRUAC TCZBDSQP TCZOPSIN TCZCLSIN TCZOPACB TCZRELIS TCZRSPER TCZSEXOS TCZCLRRV TCZVHOLD TCZLUERR TCZXSHRA TCZVRNOP TCZDEVND TCZSLSRL TCZVRDAC TCZNRLUF TCZRCLUF TCZCLEAN TCZUNBFE TCZNOISC TCZDSPCL TCZDMGF TCZPASSD TCZPSPRE TCZLUINP TCZNPSAU TCZXUVAR TCZLUINH

2 3 9 10 11 24 PRTACT 2 3 5 18 24 2 3 5 18 24

20 1 2 3 9 10 11 AOS 20 AOS 9 10 11 15 24 9 10 11 24 9 10 11 24 9 10 11 24 9 10 11 24

9 10 11 24 9 10 11 24 9 10 11 24 9 10 11 24 2 3 9 10 11 24 24 AOS 2 3 9 10 11 24

24 24 24 2 3 9 10 11 18 24 18 24

468

CICS User’s Handbook

VTAM
CICS message DFHZC3490 DFHZC3491 DFHZC3492 DFHZC3495 DFHZC3499 DFHZC4902 DFHZC4903 DFHZC4904 DFHZC4905 DFHZC4906 DFHZC4907 DFHZC4909 DFHZC4910 DFHZC4911 DFHZC4912 DFHZC4913 DFHZC4914 DFHZC4915 DFHZC4916 DFHZC4917 DFHZC4918 DFHZC4919 DFHZC4920 DFHZC4922 DFHZC4924 DFHZC4925 DFHZC4926 DFHZC4927 DFHZC4928 DFHZC4929 DFHZC4930 DFHZC4931 DFHZC4932 DFHZC4933 DFHZC4934 DFHZC4935 DFHZC4936 DFHZC4937 DFHZC4938 DFHZC4939 DFHZC4940 DFHZC4941 DFHZC4942 DFHZC4943 DFHZC4944 DFHZC4945 DFHZC4946 DFHZC4947 Action flags set 24 15 24 24 3 9 10 11 24 3 9 10 11 24 3 9 10 11 24 3 9 10 11 24 3 9 10 11 24 3 9 10 11 24 3 9 10 11 24 3 9 10 11 24 2 3 9 10 11 24 2 3 9 10 11 24 2 3 9 10 11 24 2 3 9 10 11 24 2 3 9 10 11 24 2 3 9 10 11 24 2 3 9 10 11 24 2 3 9 10 11 24 2 3 9 10 11 24 2 3 9 10 11 24 N24 2 3 5 24 2 3 5 24 2 3 5 24 2 3 5 24 24 2 3 5 24 2 3 9 10 11 24 18 24 2 3 24 2 3 24 2 3 24 2 3 24 2 3 24 2 3 5 24 2 3 5 24 2 3 5 24 2 3 5 24 2 3 5 24 2 3 5 24 3 9 10 11 24 2 3 5 24 3 9 10 11 24 2 3 24 2 3 24 Error code X'BF' X'B0' X'16' X'6B' X'C0' X'21' X'22' X'23' X'24' X'25' X'26' X'28' X'29' X'2A' X'2B' X'2C' X'2D' X'2E' X'2F' X'30' X'31' X'33' X'34' X'32' X'B6' X'B7' X'B8' X'B9' X'BD' X'B3' X'35' X'F1' X'F3' X'F4' X'F5' X'F6' X'F7' X'8A' X'8B' X'8C' X'8F' X'8D' X'8E' X'F8' X'BE' X'A2' X'F9' X'FA' Symbolic label TCZCPFAL TCZEXRO TCZDMIT TCZNOTNA TCZDWEGF TCZLUCF1 TCZLUCF2 TCZFSMBE TCZFSMCS TCZFSMCR TCZSDLER TCZRVLER TCZRVLRB TCZRLPEX TCZRLPBD TCZRLPDR TCZRLPIL TCZRLPEC TCZRLPRR TCZRLPIF TCZRLPIR TCZIVIND TCZIVDAT TCZRLXCL TCZNSEED TCZASINC TCZEVBAD TCZFMH12 TCZDESGM TCZBDBND TCZRTMT TCZBDMOD TCZICTYP TCZIDBA TCZISYNL TCZIUOW TCZIFMHL TCZLUSRR TCZLUSRF TCZLUPUN TCZLUSKN TCZLUPLK TCZLUPEX TCZFSMRB TCZBFAIL TCZPRGE TCZINVAT TCZLUSEC

Chapter 15. VTAM-associated errors

469

VTAM
CICS message DFHZC6590 DFHZC6591 DFHZC6593 DFHZC6594 DFHZC6595 DFHZC6596 DFHZC6598 Action flags set 9 10 11 15 24 24 2 3 5 24 2 3 15 24 Error code X'3F' X'3E' X'3B' X'3A' X'39' X'38' X'56' Symbolic label TCZXRST TCZXERR TCZXSBC TCZXSHR TCZXSABN TCZXSWAS 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 system sense codes.
Sense code 0001 0002 0003 0004 0007 00FF 0801 0802 0806 0807 080B 080E 080F 0811 0812 081B 081C 0824 0825 0826 0827 0829 082A 082B 082D 082E 082F 0831 0833 0847 084A 084C 0860 0863 0864 0865 0866 0867 0868 Message DFHZC3401 DFHZC3415 DFHZC3449 DFHZC3450 DFHZC3451 DFHZC3446 DFHZC2476 DFHZC2461 DFHZC3426 DFHZC3411 DFHZC2462 DFHZC3448 DFHZC3436 DFHZC2464 DFHZC2465 DFHZC2483 DFHZC2466 DFHZC2475 DFHZC2484 DFHZC3423 DFHZC2480 DFHZC3407 None DFHZC3408 DFHZC3413 DFHZC3412 DFHZC3414 DFHZC3438 DFHZC3427 DFHZC3439 None DFHZC3467 DFHZC3459 DFHZC3460 DFHZC2475 DFHZC2465 DFHZC2475 None DFHZC3456 Action flags set 2 2, 3, 10, 11 None None None 2, 3, 9, 10, 11, 23, 24 3, 9, 10, 11 None None None 2, 3, 9, 10, 11, 15, 24 23 9, 10, 11 9, 10, 11 2, 3 2, 3 2, 3, 9, 10, 11 3, 9, 10, 11 2, 3, 9, 10, 11 2, 3, 9, 10, 11 3 1, 2, 3, 10, 11, 24 9, 32 2, 3, 10, 11, 13 None None 2, 3, 9, 10, 11 None None None 32 9, 10, 11 None 9, 10, 11 3, 9, 10, 11 3, 9, 10, 11 3, 9, 10, 11 9, 10, 11 2, 9, 10, 11

© Copyright IBM Corp. 1989, 1999

471

System sense codes
Sense code 0869 08FF 1000 1001 1002 1003 1005 1008 1009 10FF 2003 20FF 400B 40FF 8000 8005 80FF FFFF Message DFHZC3457 DFHZC3447 DFHZC3494 DFHZC2481 DFHZC2481 DFHZC2479 DFHZC3406 DFHZC2478 DFHZC3458 DFHZC3446 DFHZC3405 DFHZC3445 DFHZC2477 DFHZC3453 DFHZC3435 DFHZC3435 DFHZC3435 DFHZC2460 Action flags set 2, 9, 10, 11 2, 3, 9, 10, 11, 24 2, 3, 9, 10, 11 2, 3, 9, 10, 11, 14 2, 3, 9, 10, 11, 14 2, 3, 9, 10, 11, 14 2, 3, 4, 9, 10, 11, 14 None 2, 9, 10, 11 2, 3, 9, 10, 11, 23, 24 2, 3, 9, 10, 11, 15, 24 2, 3, 9, 10, 11, 23, 24 1, 3, 11 2, 3, 9, 10, 11, 23, 24 2, 3, 9, 10, 11, 18, 24 2, 3, 9, 10, 11, 18, 24 2, 3, 9, 10, 11, 18, 23, 24 2, 3, 9, 10, 11, 23, 24

Message DFHZC2460 DFHZC2461 DFHZC2462 DFHZC2464 DFHZC2465 DFHZC2465 DFHZC2466 DFHZC2475 DFHZC2475 DFHZC2475 DFHZC2476 DFHZC2477 DFHZC2478 DFHZC2479 DFHZC2480 DFHZC2481 DFHZC2481 DFHZC2483 DFHZC2484 DFHZC3401 DFHZC3405 DFHZC3406 DFHZC3407 DFHZC3408 DFHZC3411

Sense code FFFF 0802 080B 0811 0812 0865 081C 0824 0864 0866 0801 400B 1008 1003 0827 1001 1002 081B 0825 0001 2003 1005 0829 082B 0807

Action flags set 2, 3, 9, 10, 11, 23, 24 None 2, 3, 9, 10, 11, 15, 24 9, 10, 11 2, 3 3, 9, 10, 11 2, 3, 9, 10, 11 3, 9, 10, 11 3, 9, 10, 11 3, 9, 10, 11 3, 9, 10, 11 1, 3, 11 None 2, 3, 9, 10, 11, 14 3 2, 3, 9, 10, 11, 14 2, 3, 9, 10, 11, 14 2, 3 2, 3, 9, 10, 11 2 2, 3, 9, 10, 11, 15, 24 2, 3, 4, 9, 10, 11, 14 1, 2, 3, 10, 11, 24 2, 3, 10, 11, 13 None

472

CICS User’s Handbook

System sense codes
Message DFHZC3412 DFHZC3413 DFHZC3414 DFHZC3415 DFHZC3423 DFHZC3426 DFHZC3427 DFHZC3435 DFHZC3435 DFHZC3435 DFHZC3436 DFHZC3438 DFHZC3439 DFHZC3445 DFHZC3446 DFHZC3446 DFHZC3447 DFHZC3448 DFHZC3449 DFHZC3450 DFHZC3451 DFHZC3453 DFHZC3456 DFHZC3457 DFHZC3458 DFHZC3459 DFHZC3460 DFHZC3467 DFHZC3494 None None None Sense code 082E 082D 082F 0002 0826 0806 0833 8000 8005 80FF 080F 0831 0847 20FF 00FF 10FF 08FF 080E 0003 0004 0007 40FF 0868 0869 1009 0860 0863 084C 1000 082A 084A 0867 Action flags set None None 2, 3, 9, 10, 11 2, 3, 10, 11 2, 3, 9, 10, 11 None None 2, 3, 9, 10, 11, 2, 3, 9, 10, 11, 2, 3, 9, 10, 11, 9, 10, 11 None None 2, 3, 9, 10, 11, 2, 3, 9, 10, 11, 2, 3, 9, 10, 11, 2, 3, 9, 10, 11, 23 None None None 2, 3, 9, 10, 11, 2, 9, 10, 11 2, 9, 10, 11 2, 9, 10, 11 None 9, 10, 11 9, 10, 11 2, 3, 9, 10, 11 9, 32 32 9, 10, 11

18, 24 18, 24 18, 23, 24

23, 24 23, 24 23, 24 24

23, 24

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. The default actions can vary from the actions set, depending on the state of the node at the time of the error.
Flag 1 2 3 4 5 6 9 10 11 12 13 14 15 17 18 20 21 22 23 24 TWAOPT2 Field TWAOPT1 Bit mask 1... .... .1.. .... ..1. .... ...1 .... .... 1... .... .1.. 1... .... .1.. .... ..1. .... ...1 .... .... 1... .... .1.. .... ..1. 1... .... .1.. .... ...1 .... .... 1... .... .1.. .... ..1. .... ...1 Hex bit setting "X'80'" "X'40'" "X'20'" "X'10'" "X'08'" "X'04'" "X'80'" "X'40'" "X'20'" "X'10'" "X'08'" "X'04'" "X'02'" "X'80'" "X'40'" "X'10'" "X'08'" "X'04'" "X'02'" "X'01'" Action Print action flags Print VTAM RPL Print TCTTE Print TIOA Print BIND area System dump if no task attached Abort any send for this terminal Abort any receive for " " Abend any task attached to TCTTE Cancel any task attached to TCTTE Good Morning message to be sent Purge any BMS pages for this TCTTE SIMLOGON required Set INTLOG now allowed Set no internal general logons Normal CLSDST (no reset allowed) Normal CLSDST (reset allowed) Send negative response Keep node out of service CLSDST node

TWAOPT3

474

CICS User’s Handbook

VTAM identifiers

Chapter 17. VTAM submodule identifiers
This chapter contains Product-sensitive Programming Interface information.
Hex ID X'00' X'01' X'02' X'03' X'04' X'06' X'08' X'09' X'0A' X'0B' X'0C' X'0D' X'0E' X'10' X'11' X'12' X'13' X'14' X'15' X'16' X'17' X'18' X'19' X'1A' X'1B' X'1C' X'1D' X'1E' X'1F' X'20' X'21' X'22' X'23' X'24' X'25' X'26' X'27' X'28' X'29' X'2A' X'2B' Module ZDSP ZARQ ZLOC ZDET ZTCP ZCRQ ZSTU ZTSP ZHPX ZISP ZIS1 ZIS2 ZABD ZATI ZATT ZFRE ZGET ZRAC ZRST ZRVS ZRVX ZSDS ZSDX ZUCT ZUIX ZACT ZSDR ZHPS ZRPL ZAIT ZASX ZCLS ZCLX ZDWE ZLEX ZLGX ZLRP ZLTX ZOPN ZOPX ZRAQ Description DISPATCH READ /WRITE R LOCATE DETACH TCP COMMAND REQS STATUS CHANGE TERMINAL SHARING HPO RPL EXEC OS ONLY ALLOCATE/FREE INTER SYSTEM INTER SYSTEM 2 INVALID REQUEST/ABEND ATI ATTACH TASK FREE STORAGE GET STORAGE RECEIVE ANY RESETSR RECEIVE SPEC RECEIVE S EXT SEND NORMAL SEND DATA EXIT TRANSLATION USER EXIT ACTIVATE SCAN SEND RESPONSE HPO SEND/RECV CALL RECV.ANY BLDER ATTACH INIT ASYN COM EXIT CLOSE DESTIN CLOSE DS EXIT DWE PROCESS LERAD EXIT LOGON EXIT LOGICAL REC LOSTERM EXIT OPEN DESTINAT OPEN DESTEXIT READAHEAD QUE

© Copyright IBM Corp. 1989, 1999

475

VTAM identifiers
Hex ID X'2C' X'2E' X'2F' X'30' X'31' X'32' X'33' X'34' X'35' X'36' X'37' X'38' X'39' X'3A' X'3B' X'3C' X'3D' X'3E' X'3F' X'40' X'41' X'42' X'43' X'44' X'45' X'46' X'47' X'48' X'49' X'4A' X'4B' X'4C' X'4D' X'4E' X'4F' X'50' X'52' X'53' X'54' X'55' X'56' Module ZRAR ZRRX ZNSP ZRSY ZSAX ZSCX ZSDA ZSKR ZSES ZSEX ZSIM ZSIX ZSLS ZSSX ZSYX ZTAX ZTPX ZOPA ZSHU ZQUE ZEMW ZSYN ZTRA ZAND ZCNA ZCNR ZCNC ZUAX ZUOX ZARL ZARM ZRVL ZRLX ZSDL ZSLX ZERH ZBKT ZCNT ZCHS ZCHR ZUSR Description READAHEAD RET REL REQUEST EX NETWORK SPEC EXIT RESYNC SEND COMM EXT SCIP EXIT SEND ASYN COM SEND COMMAND RESPONSE ID SESSIONC COM SESSIONC EXIT SIMLOGON SIMLOGON EXIT SETLOGON START SEND COM EXIT SYNAD EXIT TURNAROUND EXIT TPEND EXIT VTAM OPEN ACB VTAM SHUTDOWN TERMINAL SHARING ERROR MESSAGE WRITER SYNCPOINT HANDLER VTAM RPL TRACE ABEND CONTROL BLOCK CONSOLE CONTROL CONSOLE REQUEST CONSOLE ABNORMAL COND. ATTACH USER EXIT OUTPUT USER EXIT LU6.2 APPL REQUEST LU6.2 MIGRATION LU6.2 RECEIVE LU6.2 RECEIVE EXIT LU6.2 SEND LU6.2 SEND EXIT LU6.2 APPL ERP LU6.2 BRACKET STATE M/C LU6.2 CONTENTION STATE LU6.2 CHAIN SEND LU6.2 CHAIN RECEIVE LU6.2 CONVERSATION STATE

476

CICS User’s Handbook

VTAM identifiers
Hex ID X'57' X'58' X'59' X'5E' X'5F' X'60' X'61' X'62' X'63' X'64' X'65' X'66' X'67' X'7D' X'7E' X'7F' X'80' X'82' X'84' X'86' X'8B' X'C0' X'C1' X'C2' X'C3' X'C4' X'C5' X'C6' X'C7' X'C8' X'C9' X'C4' Module ZDST ZEV1 ZEV2 ZXRC ZXTS ZXRL ZINT ZXRT ZSTA ZRLP ZCRT ZRAS ZXPS ZRLG ZNAC ZRSP ZATR ZATA ZATD ZGMM ZATS ZQ00 ZQIN ZQBA ZQCH ZQDL ZQIT ZQRC ZQRS ZQIQ ZQIS ZTCT Description SNA-ASCII TRAN ROUTINE ENCRYPTION VALIDATION 1 ENCRYPTION VALIDATION 2 XRF TERMINAL RECOVERY XRF TERMINAL SCAN LU6.2 Transaction Routing Initialization Module Ident LU6.2 Transaction Routing TOS LU6.2 Application Status LU6.2 RECEIVE post-vtam LU6.2 RPL_B state LU6.2 Slow-down processing LU6.2 Per sess recovery RESPONSE LOGGER NACP RESYNC SYSTEM TASK ZATR restart deletes ZATA autoinstall ZATD autoinstall delete GOOD MORNING TRANSACTION ZATS remote install entry DFHZCQ REQUEST ROUTER ZC INITIALIZE ZC Bind Analysis ZC CHANGE ZC DELETE ZC INSTALL TCTTE ZC RECOVER ZC RESTORE ZC INQUIRE ZC INSTALL DUMMY TCTTE IDENTIFIER

Chapter 17. VTAM submodule identifiers

477

VTAM identifiers

478

CICS User’s Handbook

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 a storage accounting area (SAA). For these, the storage class value always appears in the first byte in the accounting area for a storage element. The value is sometimes modified when the top bit is set to indicate getmained storage. As an example, X'01' can appear as X'81'.
Value X'01' X'02' X'03' X'04' X'05' X'06' X'07' X'08' X'09' X'0C' X'0D' X'0E' X'11' X'12' X'13' X'14' X'16' X'20' X'21' Class TERMINAL24 CICS SHARED_CICS LINE TERMINAL TASK TASK24 CICS24 SHARED_CICS24 CICS24_SAA TRANSDATA TEMPSTG USER USER24 SHARED_CICS24_SAA CONTROL TACLE SHARED_USER24 SHARED_USER SAA No No No No No No No No No Yes Yes Yes No No Yes No Yes No No

© Copyright IBM Corp. 1989, 1999

479

Storage classes

480

CICS User’s Handbook

Sending your comments to IBM
If you especially like or dislike anything about this book, please use one of the methods listed below to send your comments to IBM. Feel free to comment on what you regard as specific errors or omissions, and on the accuracy, organization, subject matter, or completeness of this book. Please limit your comments to the information in this book and the way in which the information is presented. To request additional publications, or to ask questions or make comments about the functions of IBM products or systems, you should talk to your IBM representative or to your IBM authorized remarketer. When you send comments to IBM, you grant IBM a nonexclusive right to use or distribute your comments in any way it believes appropriate, without incurring any obligation to you. You can send your comments to IBM in any of the following ways: By mail, to this address: Information Development D epartment (MP095) IBM United Kingdom Labor atories Hursley Park WINCHESTER, Hampshire SO21 2JN United Kingdom By fax: – From outside the U.K., after your international access code use 44–1962–870229 – From within the U.K., use 01962–870229 Electronically, use the appropriate network ID: – IBM Mail Exchange: GBIBM2Q9 at IBMMAIL – IBMLink™: HURSLEY(IDRCF) – Internet: idrcf@hursley.ibm.com Whichever you use, ensure that you include: The publication number and title The topic to which your comment applies Your name and address/telephone number/fax number/network ID.

© Copyright IBM Corp. 1989, 1999

481

IBM

®

Program Number: 5655-147 Printed in the United States of America on recycled paper containing 10% recovered post-consumer fiber.

SX33-61 4- 2

Spine information:

IBM

CICS TS for OS/390

CICS User’s Handbook

Release 3