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 . . . . . . . . . . .

. . . . .

. . . . .

. . . . .

. . . . . . . . . . . . . . . . . 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 . . . . . . . . . . . . . . .

xvii xvii xvii xvii

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

. . . . .

. . . .

. . . . .

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 . . . . . . . . .

. . . . .

. . . .

. . . .

. . . .

. . . .

. . . .

1 1 2 3

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

Chapter 3. CICS-Supplied Transaction

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

167

Chapter 4. Resource definition online

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

197

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

205

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

211 211 218

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

225 225 233

Chapter 5. DFHCSDUP commands

 Copyright IBM Corp. 1989, 1999

iii

CVDA values for the DEVICE option

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

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

240

. . . . .

243 243 244 249 254

. . . . . . . . . . .

257

. . . . .

. . . . .

. . . . .

. . . . .

. . . . .

. . . . .

. . . . .

. . . . .

. . . . .

. . . . .

Chapter 10. EXEC interface block (EIB) response codes . . . . . . . . . . . . . . . . . . . . . . . Response codes of EXEC CICS commands . . . . . . . . Function codes of EXEC CICS commands

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

397 397 399

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

. . . .

. . . .

407 407 411 415

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

419 420

Chapter 13. Transaction abend codes

421

. . . .

. . . .

. . . .

. . . .

. . . .

. . . .

. . . .

. . . .

. . . .

and function

. . . .

. . . .

. . . .

. . . .

. . . .

. . . .

. . . .

. . . .

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

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

. . . . . . . . . .

463

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

465 465

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

. . . . . . . . . . . . . ˚˚˚˚˚ . . .

471 474

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

475

Chapter 18. AP domain storage classes

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

479

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

481

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

xiv

CICS User’s Handbook

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

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

2

CICS User’s Handbook

ISSUE .... PURGE MESSAGE RECEIVE .... ROUTE SEND .... SIGNOFF SIGNON WAIT TERMINAL

API syntax

API command syntax

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

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

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

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

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

Chapter 1. Command-level application programming

3

API syntax

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

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

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

Conditions: INVREQ, SYSBUSY, SYSIDERR

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

4

CICS User’s Handbook

API syntax

ASSIGN

| |

?

? | |

? ?

?

┌── ───────────────────────────┐ ┌── ───────────────────────────┐ 55──ASSIGN───6┬─────────────────────────┬┴───6┬─────────────────────────┬┴──5% ├─ABCODE(data-area)───────┤ ├─MAPWIDTH(data-area)─────┤ ├─ABDUMP(data-area)───────┤ ├─MSRCONTROL(data-area)───┤ ├─ABPROGRAM(data-area)────┤ ├─NATLANGINUSE(data-area)─┤ ├─ACTIVITY(data-area)─────┤ ├─NETNAME(data-area)──────┤ ├─ACTIVITYID(data-area)───┤ ├─NEXTTRANSID(data-area)──┤ ├─ALTSCRNHT(data-area)────┤ ├─NUMTAB(data-area)───────┤ ├─ALTSCRNWD(data-area)────┤ ├─OPCLASS(data-area)──────┤ ├─APLKYBD(data-area)──────┤ ├─OPERKEYS(data-area)─────┤ ├─APLTEXT(data-area)──────┤ ├─OPID(data-area)─────────┤ ├─APPLID(data-area)───────┤ ├─OPSECURITY(data-area)───┤ ├─ASRAINTRPT(data-area)───┤ ├─ORGABCODE(data-area)────┤ ├─ASRAKEY(cvda)───────────┤ ├─OUTLINE(data-area)──────┤ ├─ASRAPSW(data-area)──────┤ ├─PAGENUM(data-area)──────┤ ├─ASRAREGS(data-area)─────┤ ├─PARTNPAGE(data-area)────┤ ├─ASRASPC(cvda)───────────┤ ├─PARTNS(data-area)───────┤ ├─ASRASTG(cvda)───────────┤ ├─PARTNSET(data-area)─────┤ ├─BRIDGE(data-area)───────┤ ├─PRINSYSID(data-area)────┤ ├─BTRANS(data-area)───────┤ ├─PROCESS(data-area)──────┤ ├─CMDSEC(data-area)───────┤ ├─PROCESSTYPE(data-area)──┤ ├─COLOR(data-area)────────┤ ├─PROGRAM(data-area)──────┤ ├─CWALENG(data-area)──────┤ ├─PS(data-area)───────────┤ ├─DEFSCRNHT(data-area)────┤ ├─QNAME(data-area)────────┤ ├─DEFSCRNWD(data-area)────┤ ├─RESSEC(data-area)───────┤ ├─DELIMITER(data-area)────┤ ├─RESTART(data-area)──────┤ ├─DESTCOUNT(data-area)────┤ ├─RETURNPROG(data-area)───┤ ├─DESTID(data-area)───────┤ ├─SCRNHT(data-area)───────┤ ├─DESTIDLENG(data-area)───┤ ├─SCRNWD(data-area)───────┤ ├─DSSCS(data-area)────────┤ ├─SIGDATA(data-area)──────┤ ├─DS327ð(data-area)───────┤ ├─SOSI(data-area)─────────┤ ├─EWASUPP(data-area)──────┤ ├─STARTCODE(data-area)────┤ ├─EXTDS(data-area)────────┤ ├─STATIONID(data-area)────┤ ├─FACILITY(data-area)─────┤ ├─SYSID(data-area)────────┤ ├─FCI(data-area)──────────┤ ├─TASKPRIORITY(data-area)─┤ ├─GCHARS(data-area)───────┤ ├─TCTUALENG(data-area)────┤ ├─GCODES(data-area)───────┤ ├─TELLERID(data-area)─────┤ ├─GMMI(data-area)─────────┤ ├─TERMCODE(data-area)─────┤ ├─HILIGHT(data-area)──────┤ ├─TERMPRIORITY(data-area)─┤ ├─INITPARM(data-area)─────┤ ├─TEXTKYBD(data-area)─────┤ ├─INITPARMLEN(data-area)──┤ ├─TEXTPRINT(data-area)────┤ ├─INPARTN(data-area)──────┤ ├─TRANPRIORITY(data-area)─┤ ├─INVOKINGPROG(data-area)─┤ ├─TWALENG(data-area)──────┤ ├─KATAKANA(data-area)─────┤ ├─UNATTEND(data-area)─────┤ ├─LANGINUSE(data-area)────┤ ├─USERID(data-area)───────┤ ├─LDCMNEM(data-area)──────┤ ├─USERNAME(data-area)─────┤ ├─LDCNUM(data-area)───────┤ ├─USERPRIORITY(data-area)─┤ ├─MAPCOLUMN(data-area)────┤ └─VALIDATION(data-area)───┘ ├─MAPHEIGHT(data-area)────┤ └─MAPLINE(data-area)──────┘

Condition: INVREQ

Chapter 1. Command-level application programming

5

API syntax

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

Condition: LENGERR

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

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

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

Conditions: ISCINVREQ, NOTAUTH, NOTFND, SYSIDERR

6

CICS User’s Handbook

API syntax

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

Conditions: INVREQ, NOTAUTH, USERIDERR

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

Condition: INVREQ

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

?

5──┬─PROCNAME(data-area)──┬────────────────────────┬─┬─────────────────────5 │ └─PROCLENGTH(data-value)─┘ │ └─PARTNER(name)───────────────────────────────────┘ 5──┬───────────────────────────────────────────────┬───────────────────────5 └─PIPLIST(data-area)──┬───────────────────────┬─┘ └─PIPLENGTH(data-value)─┘

?

?

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

Conditions: INVREQ, LENGERR, NOTALLOC, PARTNERIDERR, TERMERR

Chapter 1. Command-level application programming

7

API syntax

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

?

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

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

Conditions: LENGERR

8

CICS User’s Handbook

API syntax

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

Conditions: EOC, LENGERR, TERMERR

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

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

Chapter 1. Command-level application programming

9

API syntax

CONVERSE (LUTYPE6.1) 55──CONVERSE──┬───────────────────────────────────────────────────────┬────5 └─FROM(data-area)──┬─FROMLENGTH(data-value)──┬──┬─────┬─┘ └─FROMFLENGTH(data-value)─┘ └─FMH─┘ 5──┬───────────────┬──┬────────────────┬──┬─INTO(data-area)─┬──────────────5 ├─CONVID(name)──┤ └─ATTACHID(name)─┘ └─SET(ptr-ref)────┘ └─SESSION(name)─┘ 5──┬─TOLENGTH(data-area)──┬──┬────────────────────────┬────────────────────5 └─TOFLENGTH(data-area)─┘ ├─MAXLENGTH(data-value)──┤ └─MAXFLENGTH(data-value)─┘ 5───┬────────────┬────┬─────────┬───5% └─NOTRUNCATE─┘ └─DEFRESP─┘

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

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

?

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

10

CICS User’s Handbook

API syntax

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

Conditions: LENGERR, TERMERR

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

Conditions: LENGERR

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

Condition: LENGERR

Chapter 1. Command-level application programming

11

API syntax

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

Condition: LENGERR

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

Conditions: LENGERR, RDATT, WRBRK

12

CICS User’s Handbook

API syntax

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

Condition: LENGERR

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

Conditions: INVREQ, LENGERR, TERMERR

Chapter 1. Command-level application programming

13

API syntax

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

Condition: LENGERR

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

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

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

Conditions: LENGERR, TERMERR

14

CICS User’s Handbook

API syntax

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

Conditions: EOC, EODS, INBFMH, LENGERR, TERMERR

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

Conditions: LENGERR, TERMERR

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

Conditions: EOC, LENGERR, TERMERR

Chapter 1. Command-level application programming

15

API syntax

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

Conditions: LENGERR, TERMERR

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

Conditions: EOF, LENGERR

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

Condition: LENGERR

16

CICS User’s Handbook

API syntax

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

Conditions: EOC, LENGERR, SIGNAL, TERMERR

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

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

CONVERSE (3790 full-function or inquiry) 55──CONVERSE──FROM(data-area)──┬─FROMLENGTH(data-value)──┬─────────────────5 └─FROMFLENGTH(data-value)─┘ 5──┬─INTO(data-area)─┬──┬─TOLENGTH(data-area)──┬───┬─────┬─────────────────5 └─SET(ptr-ref)────┘ └─TOFLENGTH(data-area)─┘ └─FMH─┘ 5───┬─────────┬───┬────────────────────────┬───┬────────────┬───5% └─DEFRESP─┘ ├─MAXLENGTH(data-value)──┤ └─NOTRUNCATE─┘ └─MAXFLENGTH(data-value)─┘

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

Chapter 1. Command-level application programming

17

API syntax

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

Conditions: LENGERR, TERMERR

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

Conditions: EXPIRED, INVREQ

18

CICS User’s Handbook

API syntax

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

|

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

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

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

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

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

Chapter 1. Command-level application programming

19

API syntax

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

┌─UOW───────────────┐ 5──┼───────────────────┼──5% ├─MAXLIFETIME(cvda)─┤ └─TASK──────────────┘

? ?

Conditions: INVREQ, LENGERR

20

CICS User’s Handbook

API syntax

DFHMDF (1 of 2) 55───┬─────┬───DFHMDF──5% └─fld─┘

┌─,─────────────────────────────────────────┐ 5───6┬─────────────────────────────────────────┬┴────────────────5 ├─POS=─┬─number────────┬──────────────────┤ │ └─(line,column)─┘ │ ├─LENGTH=number───────────────────────────┤ ├─JUSTIFY=(─┬───────┬──┬──────────────┬─)─┤ │ ├─LEFT──┤ └─,─┬─BLANK─┬──┘ │ │ └─RIGHT─┘ └─ZERO──┘ │ ├─┬─INITIAL='char-data'───────┬───────────┤ │ ├─XINIT=hex-data────────────┤ │ (1) ─┘ │ └─GINIT='DBCS-characters'── │ ├─ATTRB=(─┤ att1 ├──┤ att2 ├─)────────────┤ │ ┌─DEFAULT─┐ │ ├─COLOR=─┼─────────┼──────────────────────┤ │ └─color───┘ │ │ ┌─BASE─┐ │ └─PS=─┼──────┼────────────────────────────┘ └─psid─┘ att1: ┌─ASKIP────────────┐ ├──┼──────────────────┼─────────────────────────────────────────┤ ├─PROT─────────────┤ └─UNPROT──┬──────┬─┘ └─,NUM─┘ att2: ├──┬──────────────────────────┬─────────────────────────────────┤ │ ┌── ─────────┐ │ └─,─┬─BRT──┬───6┬───────┬┴──┘ ├─NORM─┤ ├─,DET──┤ └─DRK──┘ ├─,IC───┤ └─,FSET─┘ Notes: DBCS characters start with a shift-out character X'0E' and end with a shift-in character X'0F'.

1

Chapter 1. Command-level application programming

21

API syntax

DFHMDF (2 of 2) ┌─,───────────────────────────────┐ 55───6┬───────────────────────────────┬┴──5% │ ┌─,───────────┐ │ ├─VALIDN=(──6┬───────────┬┴─)────┤ │ ├─MUSTFILL──┤ │ │ ├─MUSTENTER─┤ │ │ └─TRIGGER───┘ │ ├─GRPNAME=group-name────────────┤ ├─OCCURS=number─────────────────┤ ├─PICIN='value'─────────────────┤ ├─PICOUT='value'────────────────┤ ├─OUTLINE=─┬─BOX─────────────┬──┤ │ │ ┌─,───────┐ │ │ │ └─(──6┬───────┬┴─)─┘ │ │ ├─LEFT──┤ │ │ ├─RIGHT─┤ │ │ ├─OVER──┤ │ │ └─UNDER─┘ │ │ ┌─NO──┐ │ ├─SOSI=─┼─────┼─────────────────┤ │ └─YES─┘ │ │ ┌─YES─┐ │ ├─TRANSP=─┼─────┼───────────────┤ │ └─NO──┘ │ └─CASE=MIXED────────────────────┘

Minimum BMS:

22

CICS User’s Handbook

API syntax

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

Standard BMS: DFHMDI ┌─,───────────────────────────────┐ 55───6┬───────────────────────────────┬┴──5% ├─PARTN=(name)─┬─────────────┬──┤ │ └─,──ACTIVATE─┘ │ ├─OBFMT=─┬─YES─┬────────────────┤ │ └─NO──┘ │ │ ┌─FIELD─┐ │ ├─DATA=─┼───────┼───────────────┤ │ └─BLOCK─┘ │ │ ┌─NO──┐ │ ├─TIOAPFX=─┼─────┼──────────────┤ │ └─YES─┘ │ └─FLDSEP=─┬─char────────┬───────┘ └─X'hex-char'─┘

Chapter 1. Command-level application programming

23

API syntax Full BMS: DFHMDI ┌─,─────────────────────┐ 55───6┬─────────────────────┬┴──5% │ ┌─SAME───┐ │ ├─COLUMN=─┼────────┼──┤ │ ├─number─┤ │ │ └─NEXT───┘ │ │ ┌─NEXT───┐ │ ├─LINE=─┼────────┼────┤ │ ├─number─┤ │ │ └─SAME───┘ │ ├─JUSTIFY=(─┤ jst ├─)─┤ ├─HEADER=YES──────────┤ └─TRAILER=YES─────────┘ jst: ┌─LEFT──┐ ├──┼───────┼──┬──────────────┬──┤ └─RIGHT─┘ └─,─┬─FIRST─┬──┘ └─LAST──┘

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

Minimum BMS:

24

CICS User’s Handbook

API syntax

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

|

| | |

┌─,───────────────────────┐ ┌─,───────────────────────────────┐ 5───6┬───────────────────────┬┴───6┬───────────────────────────────┬┴──5% │ ┌─OUT───┐ │ │ ┌─NO──┐ │ ├─MODE=─┼───────┼───────┤ ├─CURSLOC=─┼─────┼──────────────┤ │ ├─IN────┤ │ │ └─YES─┘ │ │ └─INOUT─┘ │ │ ┌─OFF───────┐ │ │ ┌─LOWER─┐ │ ├─HILIGHT=─┼───────────┼────────┤ ├─FOLD=─┼───────┼───────┤ │ ├─BLINK─────┤ │ │ └─UPPER─┘ │ │ ├─REVERSE───┤ │ │ ┌─NO──┐ │ │ └─UNDERLINE─┘ │ ├─TRIGRAPH=─┼─────┼─────┤ ├─PS=─┬─BASE─┬──────────────────┤ │ └─YES─┘ │ │ └─psid─┘ │ │ ┌─ASM────┐ │ │ ┌─,───────────┐ │ ├─LANG=─┼────────┼──────┤ ├─VALIDN=──6┬───────────┬┴───────┤ │ ├─COBOL──┤ │ │ ├─MUSTFILL──┤ │ │ ├─COBOL2─┤ │ │ ├─MUSTENTER─┤ │ │ ├─PLI────┤ │ │ ├─TRIGGER───┤ │ │ └─C──────┘ │ │ └─USEREXIT──┘ │ ├─┬──────────────┬──────┤ ├─┬─TERM=type─┬─────────────────┤ │ ├─STORAGE=AUTO─┤ │ │ └─SUFFIX=n──┘ │ │ └─BASE=name────┘ │ │ ┌─NO──┐ │ │ ┌─,────────┐ │ ├─TIOAPFX=─┼─────┼──────────────┤ ├─CTRL=(──6┬────────┬┴─)─┤ │ └─YES─┘ │ │ ├─PRINT──┤ │ │ ┌─,────────────┐ │ │ ├─length─┤ │ ├──6MAPATTS=(attr)┴──────────────┤ │ ├─FREEKB─┤ │ │ ┌─,───────────┐ │ │ ├─ALARM──┤ │ ├──6DSATTS=(attr)┴───────────────┤ │ └─FRSET──┘ │ ├─OUTLINE=─┬─BOX─────────────┬──┤ │ ┌─NO──────┐ │ │ │ ┌─,───────┐ │ │ ├─EXTATT=─┼─────────┼───┤ │ └─(──6┬───────┬┴─)─┘ │ │ ├─MAPONLY─┤ │ │ ├─LEFT──┤ │ │ └─YES─────┘ │ │ ├─RIGHT─┤ │ │ ┌─DEFAULT─┐ │ │ ├─OVER──┤ │ ├─COLOR=─┼─────────┼────┤ │ └─UNDER─┘ │ │ └─color───┘ │ │ ┌─NO──┐ │ │ ┌─ADS──┐ │ ├─SOSI=─┼─────┼─────────────────┤ └─DSECT=─┼──────┼───────┘ │ └─YES─┘ │ └─ADSL─┘ │ ┌─YES─┐ │ └─TRANSP=─┼─────┼───────────────┘ └─NO──┘

Standard BMS:

Chapter 1. Command-level application programming

25

API syntax

DFHMSD ┌─,───────────────────────────────┐ 55───6┬───────────────────────────────┬┴──5% ├─PARTN=(name)─┬─────────────┬──┤ │ └─,──ACTIVATE─┘ │ ├─LDC=mnemonic──────────────────┤ │ ┌─NO──┐ │ ├─OBFMT=─┼─────┼────────────────┤ │ └─YES─┘ │ │ ┌─,─────┐ │ 6 ├─HTAB=────tab──┴───────────────┤ │ ┌─,─────┐ │ ├─VTAB=──6──tab──┴───────────────┤ │ ┌─FIELD─┐ │ ├─DATA=─┼───────┼───────────────┤ │ └─BLOCK─┘ │ └─FLDSEP=─┬─char────────┬───────┘ └─X'hex-char'─┘

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

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

26

CICS User’s Handbook

API syntax

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

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

Conditions: INVREQ, NOTFND, SYMBOLERR, TEMPLATERR

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

Conditions: DUPREC, INVREQ, NOTFND, TEMPLATERR

Chapter 1. Command-level application programming

27

API syntax

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

Conditions: LENGERR, NOTFND

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

Conditions: NOTFND, SYMBOLERR

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

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

28

CICS User’s Handbook

API syntax

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

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

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

?

┌─UOW───────────────┐ 5──┼───────────────────┼───┬───────────┬───5% ├─MAXLIFETIME(cvda)─┤ └─NOSUSPEND─┘ └─TASK──────────────┘

Conditions: ENQBUSY, INVREQ, LENGERR

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

?

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

?

Conditions: INVREQ, LENGERR

Chapter 1. Command-level application programming

29

API syntax

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

Conditions: CBIDERR, INVREQ, NOTALLOC

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

Conditions: CBIDERR, INVREQ, NOTALLOC

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

Conditions: INVREQ, NOTALLOC

30

CICS User’s Handbook

API syntax

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

Conditions: INVREQ, NOTALLOC

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

Conditions: INVREQ, LENGERR

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

?

Condition: NOTALLOC

Chapter 1. Command-level application programming

31

API syntax

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

?

?

Conditions: INVREQ, LENGERR, NOTALLOC

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

?

Condition: INVREQ, NOTALLOC

32

CICS User’s Handbook

API syntax

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

Condition: INVREQ

FREE 55──FREE──5%

Condition: NOTALLOC

FREE (APPC) ?

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

Conditions: INVREQ, NOTALLOC

Chapter 1. Command-level application programming

33

API syntax

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

Conditions: INVREQ, NOTALLOC

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

?

Conditions: INVREQ, NOTALLOC

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

Condition: INVREQ

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

?

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

?

34

CICS User’s Handbook

API syntax

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

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

?

5──┬─PROCNAME(name)──┬────────────────────────┬─┬──────────────────────────5 │ └─PROCLENGTH(data-value)─┘ │ └─PARTNER(name)──────────────────────────────┘ 5──┬───────────────────────────────────────────────┬───────────────────────5 └─PIPLIST(data-area)──┬───────────────────────┬─┘ └─PIPLENGTH(data-value)─┘ 5──SYNCLEVEL(data-value)──CONVDATA(data-area)──RETCODE(data-area)──────────5

?

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

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

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

?

maxproclen: ├──┬────────────────────────┬──┤ └─MAXPROCLEN(data-value)─┘

Chapter 1. Command-level application programming

35

API syntax

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

?

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

?

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

?

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

?

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

?

36

CICS User’s Handbook

API syntax

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

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

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

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

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

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

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

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

Chapter 1. Command-level application programming

37

API syntax

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

? ?

Conditions: LENGERR, NOSTG

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

?

Conditions: NOTAUTH, PGMIDERR (PROGRAM only)

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

Condition: INVREQ

38

CICS User’s Handbook

API syntax

HANDLE CONDITION ┌── ────────────────────────┐ 55──HANDLE CONDITION───6─condition──┬─────────┬─┴──5% └─(label)─┘

IGNORE CONDITION ┌── ───────────┐ 55──IGNORE CONDITION───6─condition─┴──5%

ISSUE ABEND (APPC) ?

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

Conditions: INVREQ, NOTALLOC, TERMERR

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

Conditions: FUNCERR, INVREQ, SELNERR, UNEXPIN

Chapter 1. Command-level application programming

39

API syntax

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

Conditions: FUNCERR, INVREQ, SELNERR, UNEXPIN

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

?

Conditions: INVREQ, NOTALLOC, SIGNAL, TERMERR

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

?

Condition: NOTALLOC, TERMIDERR

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

?

Conditions: LENGERR, NOTALLOC, TERMERR

40

CICS User’s Handbook

API syntax

ISSUE DISCONNECT (default) 55──ISSUE DISCONNECT──5%

Conditions: SIGNAL, TERMERR

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

Conditions: NOTALLOC, TERMERR

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

Conditions: FUNCERR, INVREQ, SELNERR, UNEXPIN

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

?

Condition: INVREQ, NOTALLOC

Chapter 1. Command-level application programming

41

API syntax

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

?

Condition: INVREQ, NOTALLOC

ISSUE EODS 55──ISSUE EODS──5%

?

Conditions: INVREQ, NOTALLOC, TERMERR

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

Conditions: FUNCERR, INVREQ, SELNERR, UNEXPIN

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

?

Conditions: INVREQ, NOTALLOC, TERMERR

42

CICS User’s Handbook

API syntax

ISSUE ERROR (APPC) ?

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

Conditions: INVREQ, NOTALLOC, SIGNAL, TERMERR

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

?

Conditions: NONVAL, NOTALLOC, NOSTART, TERMERR

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

Conditions: FUNCERR, INVREQ, SELNERR, UNEXPIN

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

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

?

Conditions: INVREQ, LENGERR, NOTALLOC

Chapter 1. Command-level application programming

43

API syntax

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

?

?

Conditions: INVREQ, NOTALLOC, TERMERR

ISSUE PRINT 55──ISSUE PRINT──5%

?

Conditions: INVREQ, NOTALLOC, TERMERR

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

Conditions: FUNCERR, INVREQ, SELNERR, UNEXPIN

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

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

44

CICS User’s Handbook

API syntax

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

Conditions: FUNCERR, INVREQ, SELNERR, UNEXPIN

ISSUE RESET 55──ISSUE RESET──5%

Condition: INVREQ, NOTALLOC

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

Conditions: FUNCERR, IGREQCD, INVREQ, SELNERR, UNEXPIN

Chapter 1. Command-level application programming

45

API syntax

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

?

?

Conditions: INVREQ, NOTALLOC, TERMERR

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

Conditions: NOTALLOC, TERMERR

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

Conditions: FUNCERR, INVREQ, SELNERR, UNEXPIN

46

CICS User’s Handbook

API syntax

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

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

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

Conditions: INVREQ, LENGERR, NOTAUTH, PGMIDERR

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

Condition: INVREQ

Chapter 1. Command-level application programming

47

API syntax

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

Condition: NOTALLOC

POP HANDLE 55──POP HANDLE──5%

Condition: INVREQ

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

Conditions: EXPIRED, INVREQ

PURGE MESSAGE 55──PURGE MESSAGE──5%

Conditions: Full BMS: INVREQ, TSIOERR

48

CICS User’s Handbook

API syntax

PUSH HANDLE 55──PUSH HANDLE──5%

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

Conditions: INVREQ, LENGERR, NOTFND, QIDERR

READ ┌─UNCOMMITTED──────────────────┐ 55──READ──FILE(filename)──┼──────────────────────────────┼─────────────────5 ├─CONSISTENT───────────────────┤ ├─REPEATABLE───────────────────┤ └─UPDATE──┬──────────────────┬─┘ └─TOKEN(data-area)─┘ 5──┬─INTO(data-area)─┬──┬───────────────────┬──RIDFLD(data-area)───────────5 └─SET(ptr-ref)────┘ └─LENGTH(data-area)─┘ 5──┬────────────────────────────────────┬──┬───────────────────┬───────────5 └─KEYLENGTH(data-value)──┬─────────┬─┘ └─SYSID(systemname)─┘ └─GENERIC─┘ ┌─EQUAL─┐ 5──┬────────┬──┼───────┼──┬───────────┬──5% ├─RBA────┤ └─GTEQ──┘ └─NOSUSPEND─┘ ├─RRN────┤ ├─DEBKEY─┤ └─DEBREC─┘

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

Chapter 1. Command-level application programming

49

API syntax

READNEXT 55──READNEXT──FILE(filename)──┬─INTO(data-area)─┬──────────────────────────5 └─SET(ptr-ref)────┘ ┌─UNCOMMITTED──────────────┐ 5──┼──────────────────────────┼──┬───────────────────┬─────────────────────5 ├─CONSISTENT───────────────┤ └─LENGTH(data-area)─┘ ├─REPEATABLE───────────────┤ └─UPDATE──TOKEN(data-area)─┘ 5──RIDFLD(data-area)──┬───────────────────────┬──┬───────────────────┬─────5 └─KEYLENGTH(data-value)─┘ └─REQID(data-value)─┘ 5──┬───────────────────┬──┬─────┬──┬───────────┬──5% └─SYSID(systemname)─┘ ├─RBA─┤ └─NOSUSPEND─┘ └─RRN─┘

|

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

READPREV 55──READPREV──FILE(filename)──┬─INTO(data-area)─┬──────────────────────────5 └─SET(ptr-ref)────┘ ┌─UNCOMMITTED──────────────┐ 5──┼──────────────────────────┼──┬───────────────────┬─────────────────────5 ├─CONSISTENT───────────────┤ └─LENGTH(data-area)─┘ ├─REPEATABLE───────────────┤ └─UPDATE──TOKEN(data-area)─┘ 5──RIDFLD(data-area)──┬───────────────────────┬──┬───────────────────┬─────5 └─KEYLENGTH(data-value)─┘ └─REQID(data-value)─┘ 5──┬───────────────────┬──┬─────┬──┬───────────┬──5% └─SYSID(systemname)─┘ ├─RBA─┤ └─NOSUSPEND─┘ └─RRN─┘

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

50

CICS User’s Handbook

API syntax

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

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

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

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

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

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

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

Chapter 1. Command-level application programming

51

API syntax

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

Conditions: INVREQ, LENGERR, NOTALLOC

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

Conditions: EOC, INVREQ, LENGERR, TERMERR

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

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

52

CICS User’s Handbook

API syntax

RECEIVE (LUTYPE6.1) 55──RECEIVE──┬───────────────┬──┬─INTO(data-area)─┬────────────────────────5 └─SESSION(name)─┘ └─SET(ptr-ref)────┘ 5──┬─LENGTH(data-area)──┬──┬────────────────────────┬───┬────────────┬───5% └─FLENGTH(data-area)─┘ ├─MAXLENGTH(data-value)──┤ └─NOTRUNCATE─┘ └─MAXFLENGTH(data-value)─┘

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

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

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

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

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

Conditions: INVREQ, LENGERR

Chapter 1. Command-level application programming

53

API syntax

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

Conditions: INVREQ, LENGERR

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

Conditions: INVREQ, LENGERR

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

Conditions: INVREQ, LENGERR, RDATT

54

CICS User’s Handbook

API syntax

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

Conditions: INVREQ, LENGERR, NOPASSBKRD

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

Conditions: INVREQ, LENGERR

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

Conditions: INVREQ, LENGERR, TERMERR

Chapter 1. Command-level application programming

55

API syntax

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

Conditions: INVREQ, LENGERR

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

Conditions: INVREQ, LENGERR, NOTALLOC

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

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

56

CICS User’s Handbook

API syntax

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

Conditions: INVREQ, LENGERR, TERMERR

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

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

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

Conditions: EOF, INVREQ, LENGERR

Chapter 1. Command-level application programming

57

API syntax

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

Conditions: EOF, ENDINPT, INVREQ, LENGERR

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

Conditions: EOC, INVREQ, LENGERR, SIGNAL, TERMERR

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

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

58

CICS User’s Handbook

API syntax

RECEIVE (3790 full-function or inquiry) 55──RECEIVE──┬─────────────────────┬──┬─LENGTH(data-area)──┬───────────────5 └─┬─INTO(data-area)─┬─┘ └─FLENGTH(data-area)─┘ └─SET(ptr-ref)────┘ 5──┬────────────────────────┬───┬────────────┬───5% ├─MAXLENGTH(data-value)──┤ └─NOTRUNCATE─┘ └─MAXFLENGTH(data-value)─┘

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

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

Conditions: INVREQ, LENGERR, TERMERR

Chapter 1. Command-level application programming

59

API syntax

RECEIVE MAP 55──RECEIVE MAP(name)──┬──────────────┬──┬─────────────────┬───────────────5 └─MAPSET(name)─┘ ├─INTO(data-area)─┤ └─SET(ptr-ref)────┘ ┌─TERMINAL────────────────────────────────┐ 5──┼─────────────────────────────────────────┼──5% ├─FROM(data-area)──┬────────────────────┬─┤ │ └─LENGTH(data-value)─┘ │ └─TERMINAL──┬──────┬──┬───────────────┬───┘ └─ASIS─┘ └─INPARTN(name)─┘

Conditions: EOC, EODS, INVMPSZ, INVPARTN, INVREQ, MAPFAIL, PARTNFAIL, RDATT, UNEXPIN Note: INPARTN is supported by Standard and full BMS

RECEIVE MAP MAPPINGDEV 55──RECEIVE MAP(name)──MAPPINGDEV(data-value)──FROM(data-area)─────────────5 5──┬────────────────────┬──┬──────────────┬──┬─────────────────┬──5% └─LENGTH(data-value)─┘ └─MAPSET(name)─┘ ├─INTO(data-area)─┤ └─SET(ptr-ref)────┘

Conditions: INVMPSZ, INVREQ, MAPFAIL,

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

Standard and full BMS:

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

Conditions: EOC, EODS, INVPARTN, INVREQ, LENGERR

60

CICS User’s Handbook

API syntax

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

Conditions: INVREQ, NOTAUTH, PGMIDERR

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

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

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

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

Chapter 1. Command-level application programming

61

API syntax

RETURN 55──RETURN──┬────────────────────────────────────────────────┬─────────────5 └─TRANSID(name)──┬──────────────┬──┬───────────┬─┘ └─┤ commarea ├─┘ └─IMMEDIATE─┘ 5──┬──────────────────────────────────────────────────┬────────────────────5 └─INPUTMSG(data-area)──┬─────────────────────────┬─┘ └─INPUTMSGLEN(data-value)─┘ 5──┬─────────────┬──5% └─ENDACTIVITY─┘

|

commarea: ├──COMMAREA(data-area)──┬────────────────────┬──┤ └─LENGTH(data-value)─┘

Conditions: INVREQ, LENGERR

REWRITE 55──REWRITE──FILE(filename)──┬──────────────────┬──FROM(data-area)─────────5 └─TOKEN(data-area)─┘ 5──┬────────────────────┬──┬───────────────────┬───┬───────────┬───5% └─LENGTH(data-value)─┘ └─SYSID(systemname)─┘ └─NOSUSPEND─┘

|

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

62

CICS User’s Handbook

API syntax

ROUTE ┌─INTERVAL(ð)──────────────────────┐ 55──ROUTE──┼──────────────────────────────────┼──┬─────────────────────┬───5 ├─INTERVAL(hhmmss)─────────────────┤ └─ERRTERM──┬────────┬─┘ ├─TIME(hhmmss)─────────────────────┤ └─(name)─┘ │ ┌── ───────────────────────┐ │ 6 ├─AFTER───┬─HOURS(data-value)───┬┴─┤ │ ├─MINUTES(data-value)─┤ │ │ └─SECONDS(data-value)─┘ │ │ ┌── ───────────────────────┐ │ 6 └─AT───┬─HOURS(data-value)───┬┴────┘ ├─MINUTES(data-value)─┤ └─SECONDS(data-value)─┘ 5──┬──────────────────┬──┬─────────────────┬──┬────────────────────┬───────5 └─TITLE(data-area)─┘ └─LIST(data-area)─┘ └─OPCLASS(data-area)─┘ 5──┬─────────────┬──┬───────────┬───┬───────┬───5% └─REQID(name)─┘ └─LDC(name)─┘ └─NLEOM─┘

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

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

5──┬────────┬──┬─────────┬──┬─────────────┬──5% ├─INVITE─┤ ├─CONFIRM─┤ └─STATE(cvda)─┘ └─LAST───┘ └─WAIT────┘

Conditions: INVREQ, LENGERR, NOTALLOC, SIGNAL, TERMERR

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

Conditions: INVREQ, LENGERR, NOTALLOC

Chapter 1. Command-level application programming

63

API syntax

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

Conditions: INVREQ, LENGERR, TERMERR

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

Conditions: INVREQ, IGREQCD, LENGERR, SIGNAL, TERMERR

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

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

64

CICS User’s Handbook

API syntax

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

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

Conditions: CBIDERR, INVREQ, LENGERR, NOTALLOC, TERMERR

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

Conditions: INVREQ, LENGERR, TERMERR

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

Conditions: INVREQ, LENGERR

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

Conditions: INVREQ, LENGERR

Chapter 1. Command-level application programming

65

API syntax

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

Conditions: INVREQ, LENGERR

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

Conditions: INVREQ, LENGERR, WRBRK

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

Conditions: INVREQ, LENGERR, NOPASSBKWR

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

Conditions: INVREQ, LENGERR

66

CICS User’s Handbook

API syntax

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

Conditions: INVREQ, LENGERR, TERMERR

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

Conditions: INVREQ, LENGERR

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

Conditions: INVREQ, LENGERR, TERMERR

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

Conditions: INVREQ, LENGERR, SIGNAL, TERMERR

Chapter 1. Command-level application programming

67

API syntax

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

Conditions: INVREQ, LENGERR, TERMERR

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

Conditions: INVREQ, LENGERR, TERMERR

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

Conditions: INVREQ, LENGERR, TERMERR

68

CICS User’s Handbook

API syntax

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

Conditions: INVREQ, LENGERR, TERMERR

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

Conditions: INVREQ, LENGERR, TERMERR

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

Conditions: INVREQ, LENGERR

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

Conditions: INVREQ, LENGERR

Chapter 1. Command-level application programming

69

API syntax

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

Conditions: INVREQ, LENGERR, SIGNAL, TERMERR

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

Conditions: INVREQ, LENGERR, SIGNAL, TERMERR

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

Conditions: INVREQ, LENGERR, SIGNAL, TERMERR

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

Conditions: INVREQ, LENGERR, TERMERR

70

CICS User’s Handbook

API syntax

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

Conditions: INVREQ, LENGERR, TERMERR

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

Conditions: INVREQ, LENGERR, TERMERR

Chapter 1. Command-level application programming

71

API syntax

SEND CONTROL 55──SEND CONTROL──5%

Minimum BMS:

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

Standard BMS:

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

Full BMS:

72

CICS User’s Handbook

API syntax

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

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

Chapter 1. Command-level application programming

73

API syntax

SEND MAP 55──SEND MAP(name)──5%

Minimum BMS:

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

Standard BMS:

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

Full BMS:

74

CICS User’s Handbook

API syntax

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

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

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

Conditions: INVMPSZ, INVREQ

Chapter 1. Command-level application programming

75

API syntax

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

Conditions: IGREQCD, INVREQ, RETPAGE, TSIOERR, WRBRK

SEND PARTNSET 55──SEND PARTNSET──┬────────┬──5% └─(name)─┘

Conditions: INVPARTNSET, INVREQ

SEND TEXT 55──SEND TEXT──5%

Standard BMS:

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

76

CICS User’s Handbook

API syntax Full BMS:

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

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

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

Conditions: IGREQCD, IGREQID, INVREQ, TSIOERR, WRBRK

Chapter 1. Command-level application programming

77

API syntax

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

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

SIGNOFF 55──SIGNOFF──5%

Condition: INVREQ

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

Conditions: INVREQ, NOTAUTH, USERIDERR

78

CICS User’s Handbook

API syntax

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

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

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

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

SPOOLOPEN OUTPUT 55──SPOOLOPEN OUTPUT──TOKEN(data-area)──USERID(data-value)─────────────────5 5──NODE(data-value)──┬───────────────────┬──┬───────────────────┬──────────5 └─CLASS(data-value)─┘ └─OUTDESCR(ptr-ref)─┘ ┌─NOCC─┐ ┌─PRINT───────────────────────────────┐ 5──┼──────┼──┼─────────────────────────────────────┼───────────────────────5 ├─ASA──┤ ├─PRINT──┬──────────────────────────┬─┤ └─MCC──┘ │ └─RECORDLENGTH(data-value)─┘ │ └─PUNCH───────────────────────────────┘ ┌── ───────────────────┐ 5───6┬─NOHANDLE────────┬┴──5% └─RESP──┬───────┬─┘ └─RESP2─┘

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

Chapter 1. Command-level application programming

79

API syntax

SPOOLREAD 55──SPOOLREAD──TOKEN(data-area)──INTO(data-area)───────────────────────────5 5──┬────────────────────────┬──┬──────────────────────┬────────────────────5 └─MAXFLENGTH(data-value)─┘ └─TOFLENGTH(data-area)─┘ ┌── ───────────────────┐ 5───6┬─NOHANDLE────────┬┴──5% └─RESP──┬───────┬─┘ └─RESP2─┘

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

SPOOLWRITE 55──SPOOLWRITE──TOKEN(data-area)──FROM(data-area)──────────────────────────5 ┌─LINE─┐ ┌── ───────────────────┐ 5──┬─────────────────────┬──┼──────┼───6┬─NOHANDLE────────┬┴──5% └─FLENGTH(data-value)─┘ └─PAGE─┘ └─RESP──┬───────┬─┘ └─RESP2─┘

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

80

CICS User’s Handbook

API syntax

START ┌─INTERVAL(ð)──────────────────────┐ 55──START──TRANSID(name)──┼──────────────────────────────────┼─────────────5 ├─INTERVAL(hhmmss)─────────────────┤ ├─TIME(hhmmss)─────────────────────┤ │ ┌── ───────────────────────┐ │ ├─AFTER───6┬─HOURS(data-value)───┬┴─┤ │ ├─MINUTES(data-value)─┤ │ │ └─SECONDS(data-value)─┘ │ │ ┌── ───────────────────────┐ │ 6 └─AT───┬─HOURS(data-value)───┬┴────┘ ├─MINUTES(data-value)─┤ └─SECONDS(data-value)─┘ 5──┬─────────────┬──┬──────────────────────────────────────────────┬───────5 └─REQID(name)─┘ └─FROM(data-area)──LENGTH(data-value)──┬─────┬─┘ └─FMH─┘ 5──┬────────────────────┬──┬───────────────────┬──┬────────────────┬───────5 ├─TERMID(name)───────┤ └─SYSID(systemname)─┘ └─RTRANSID(name)─┘ └─USERID(data-value)─┘ 5──┬───────────────┬──┬─────────────┬───┬─────────┬────┬─────────┬───5% └─RTERMID(name)─┘ └─QUEUE(name)─┘ └─NOCHECK─┘ └─PROTECT─┘

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

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

Conditions: INVREQ, LENGERR, NOTAUTH, TRANSIDERR

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

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

Chapter 1. Command-level application programming

81

API syntax

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

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

SUSPEND 55──SUSPEND──5%

SYNCPOINT 55──SYNCPOINT──5%

Conditions: INVREQ, ROLLEDBACK

SYNCPOINT ROLLBACK 55──SYNCPOINT──ROLLBACK──5%

Condition: INVREQ

82

CICS User’s Handbook

API syntax

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

Conditions: INVREQ, LENGERR

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

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

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

Conditions: INVREQ, NOTAUTH, USERIDERR

Chapter 1. Command-level application programming

83

API syntax

WAIT CONVID (APPC) 55──WAIT CONVID(name)──┬─────────────┬──5% └─STATE(cvda)─┘

?

Conditions: INVREQ, NOTALLOC

WAIT EVENT 55──WAIT EVENT──ECADDR(ptr-value)──┬────────────┬──5% └─NAME(name)─┘

?

Condition: INVREQ

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

?

Condition: INVREQ

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

Conditions: INVREQ, IOERR, JIDERR, NOTOPEN

84

CICS User’s Handbook

API syntax

WAIT SIGNAL 55──WAIT SIGNAL──5%

Conditions: NOTALLOC, SIGNAL, TERMERR

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

Conditions: INVREQ, NOTALLOC, SIGNAL

WAITCICS 55──WAITCICS──ECBLIST(ptr-value)──NUMEVENTS(data-value)────────────────────5

?

┌─PURGEABLE──────────┐ 5──┼────────────────────┼──┬────────────┬──5% ├─PURGEABILITY(cvda)─┤ └─NAME(name)─┘ └─NOTPURGEABLE───────┘

Condition: INVREQ

WEB ENDBROWSE 55──WEB──ENDBROWSE──HTTPHEADER──5%

Conditions: INVREQ

Chapter 1. Command-level application programming

85

API syntax

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

Conditions: INVREQ, LENGERR

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

Conditions:INVREQ, LENGERR, NOTFND

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

Conditions:ENDFILE, INVREQ, LENGERR

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

Conditions:INVREQ, LENGERR

86

CICS User’s Handbook

API syntax

WEB RETRIEVE 55──WEB──RETRIEVE──DOCTOKEN(data-area)──5%

Conditions:INVREQ

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

Conditions:INVREQ, NOTFND

WEB STARTBROWSE 55──WEB──STARTBROWSE──HTTPHEADER──5%

Conditions:INVREQ

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

Conditions:INVREQ

Chapter 1. Command-level application programming

87

API syntax

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

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

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

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

88

CICS User’s Handbook

API syntax

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

Conditions: EXPIRED, INVREQ, LENGERR

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

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

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

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

Chapter 1. Command-level application programming

89

API syntax

XCTL 55──XCTL──PROGRAM(name)──┬─────────────────────────────────────────────┬───5 └─COMMAREA(data-area)──┬────────────────────┬─┘ └─LENGTH(data-value)─┘ 5──┬──────────────────────────────────────────────────┬──5% └─INPUTMSG(data-area)──┬─────────────────────────┬─┘ └─INPUTMSGLEN(data-value)─┘

Conditions: INVREQ, LENGERR, NOTAUTH, PGMIDERR

90

CICS User’s Handbook

SPI syntax

Chapter 2. SPI command syntax This chapter contains General-use Programming Interface information.

ACQUIRE TERMINAL 55──ACQUIRE TERMINAL(data-value)──┬──────────────────────┬─────────────────5 ├─NOQUEUE──────────────┤ ├─QALL──┬────────┬─────┤ │ └─RELREQ─┘ │ ├─QNOTENAB─────────────┤ └─QSESSLIM──┬────────┬─┘ └─RELREQ─┘ 5──┬───────────────────────────────────────────────────┬──5% └─USERDATA(data-value)──┬─────────────────────────┬─┘ └─USERDATALEN(data-value)─┘

Conditions: INVREQ, LENGERR, NOTAUTH, TERMIDERR

 Copyright IBM Corp. 1989, 1999

91

SPI syntax

COLLECT STATISTICS 55──COLLECT STATISTICS SET(ptr-ref)──┬──────────────────────┬──────────────5 ├─LASTRESET(data-area)─┤ └─┤ COL3 ├─────────────┘ 5──┬─AUTOINSTALL──────────────────────────────┬──5% ├─CONNECTION(data-value)───────────────────┤ ├─DB2CONN──────────────────────────────────┤ ├─DB2ENTRY(data-value)─────────────────────┤ ├─DISPATCHER───────────────────────────────┤ ├─ENQUEUE──────────────────────────────────┤ ├─FILE(data-value)─────────────────────────┤ ├─JOURNALNAME(data-value)──────────────────┤ ├─JOURNALNUM(data-value)───────────────────┤ ├─LSRPOOL(data-value)──────────────────────┤ ├─MONITOR─┬──────────────┬─────────────────┤ │ └─(data-value)─┘ │ ├─NODE(data-value)──TARGET(data-value)─────┤ ├─POOL(data-value)──┬────────────────────┬─┤ │ └─TARGET(data-value)─┘ │ ├─PROGAUTO─────────────────────────────────┤ ├─PROGRAM─┬──────────────┬─────────────────┤ │ └─(data-value)─┘ │ ├─RECOVERY─────────────────────────────────┤ ├─STORAGE─┬──────────────┬─────────────────┤ │ └─(data-value)─┘ │ ├─STREAMNAME(data-value)───────────────────┤ ├─SYSDUMPCODE─┬──────────────┬─────────────┤ │ └─(data-value)─┘ │ ├─TABLEMGR─────────────────────────────────┤ ├─TCLASS(data-value)───────────────────────┤ ├─TCPIPSERVICE(data-value)─────────────────┤ ├─TDQUEUE─┬──────────────┬─────────────────┤ │ └─(data-value)─┘ │ ├─TERMINAL(data-value)─────────────────────┤ ├─TRANCLASS(data-value)────────────────────┤ ├─TRANDUMPCODE─┬──────────────┬────────────┤ │ └─(data-value)─┘ │ ├─TRANSACTION─┬──────────────┬─────────────┤ │ └─(data-value)─┘ │ ├─TSQUEUE──────────────────────────────────┤ └─VTAM─────────────────────────────────────┘

|

COL3: ├──┤ COL4 ├──LASTRESETMIN(data-area)──LASTRESETSEC(data-area)──┤ COL4: ├──LASTRESETHRS(data-area)──┤

Conditions: INVREQ, IOERR, NOTAUTH, NOTFND

92

CICS User’s Handbook

SPI syntax

CREATE CONNECTION 55──CREATE CONNECTION(data-value)──────────────────────────────────────────5 5──┬─ATTRIBUTES(data-value)ATTRLEN(data-value)─┬──5% ├─COMPLETE──────────────────────────────────┤ └─DISCARD───────────────────────────────────┘

Conditions: ILLOGIC, INVREQ, LENGERR, NOTAUTH

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

Chapter 2. SPI command syntax

93

SPI syntax

CREATE DB2CONN 55──CREATE DB2CONN(data-value)─────────────────────────────────────────────5 5────ATTRIBUTES(data-value)ATTRLEN(data-value)────5%

Conditions: ILLOGIC, INVREQ, LENGERR, NOTAUTH

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

94

CICS User’s Handbook

SPI syntax

CREATE DB2ENTRY 55──CREATE DB2ENTRY(data-value)────────────────────────────────────────────5 5────ATTRIBUTES(data-value)ATTRLEN(data-value)────5%

Conditions: ILLOGIC, INVREQ, LENGERR, NOTAUTH

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

CREATE DB2TRAN 55──CREATE DB2TRAN(data-value)─────────────────────────────────────────────5 5────ATTRIBUTES(data-value)ATTRLEN(data-value)────5%

Conditions: ILLOGIC, INVREQ, LENGERR, NOTAUTH

Chapter 2. SPI command syntax

95

SPI syntax

CREATE DB2TRAN DB2TRAN attributes: ├──┬─────────────────────┬──ENTRY(char8)──┬────────────────┬──┤ └─DESCRIPTION(char58)─┘ └─TRANSID(char4)─┘

CREATE DOCTEMPLATE 55──CREATE DOCTEMPLATE(data-value)─────────────────────────────────────────5 5────ATTRIBUTES(data-value)ATTRLEN(data-value)────5%

Conditions: ILLOGIC, INVREQ, LENGERR, NOTAUTH

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

||

CREATE ENQMODEL

|

55──CREATE ENQMODEL(data-value)────────────────────────────────────────────5

|

5────ATTRIBUTES(data-value)ATTRLEN(data-value)────5%

|

Conditions: INVREQ, LENGERR, NOTAUTH

96

CICS User’s Handbook

SPI syntax

||

CREATE ENQMODEL

| | |

ENQMODEL attributes: ├──┬─────────────────────┬──ENQNAME(char1-255)──┬─────────────────┬────────5 └─DESCRIPTION(char58)─┘ └─ENQSCOPE(char4)─┘

| | |

┌─STATUS(ENABLED)──┐ 5──┼──────────────────┼──┤ └─STATUS(DISABLED)─┘

CREATE FILE 55──CREATE FILE(data-value)────ATTRIBUTES(data-value)──────────────────────5 5──ATTRLEN(data-value)──5%

Conditions: ILLOGIC, INVREQ, LENGERR, NOTAUTH

CREATE FILE FILE attributes (1/2): ┌─ADD(NO)──┐ ┌─BACKUPTYPE(STATIC)──┐ ┌─BROWSE(NO)──┐ ├──┼──────────┼──┼─────────────────────┼──┼─────────────┼──────────────────5 └─ADD(YES)─┘ └─BACKUPTYPE(DYNAMIC)─┘ └─BROWSE(YES)─┘

|

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

Chapter 2. SPI command syntax

97

SPI syntax

CREATE FILE FILE attributes (2/2): |

┌─LOAD(NO)──┐ ├──┬────────────────────────────────┬──┼───────────┼───────────────────────5 └─KEYLENGTH(1-255|1-16 for CFDT)─┘ └─LOAD(YES)─┘

| |

┌─LSRPOOLID(1)────┐ ┌─MAXNUMRECS(NOLIMIT)────────┐ 5──┼─────────────────┼──┼────────────────────────────┼─────────────────────5 ├─LSRPOOLID(NONE)─┤ └─┬────────────────────────┬─┘ └─LSRPOOLID(1-8)──┘ └─MAXNUMRECS(1-99999999)─┘

|

┌─OPENTIME(FIRSTREF)─┐ 5──┬─────────────────┬──┼────────────────────┼──┬─────────────────┬────────5 └─NSRGROUP(char8)─┘ └─OPENTIME(STARTUP)──┘ └─PASSWORD(char8)─┘ ┌─READ(YES)─┐ ┌─READINTEG(UNCOMMITTED)─┐ ┌─RECORDFORMAT(V)─┐ 5──┼───────────┼──┼────────────────────────┼──┼─────────────────┼──────────5 └─READ(NO)──┘ ├─READINTEG(CONSISTENT)──┤ └─RECORDFORMAT(F)─┘ └─READINTEG(REPEATABLE)──┘ ┌─RECOVERY(NONE)────────┐ 5──┬─────────────────────┬──┼───────────────────────┼──────────────────────5 └─RECORDSIZE(1-32767)─┘ ├─RECOVERY(ALL)─────────┤ └─RECOVERY(BACKOUTONLY)─┘ ┌─RLSACCESS(NO)──┐ 5──┬────────────────────────────────────────────┬──┼────────────────┼──────5 └─REMOTESYSTEM(char4)─┬───────────────────┬──┘ └─RLSACCESS(YES)─┘ └─REMOTENAME(char8)─┘ ┌─STATUS(ENABLED)───┐ ┌─STRINGS(1)─────┐ ┌─TABLE(NO)───┐ 5──┼───────────────────┼──┼────────────────┼──┼─────────────┼──────────────5 ├─STATUS(DISABLED)──┤ └─STRINGS(1-255)─┘ ├─TABLE(CF)───┤ └─STATUS(UNENABLED)─┘ ├─TABLE(CICS)─┤ └─TABLE(USER)─┘

|

|

┌─UPDATE(NO)──┐ ┌─UPDATEMODEL(LOCKING)────┐ 5──┬──────────────────┬──┼─────────────┼──┼─────────────────────────┼──┤ └─TABLENAME(char8)─┘ └─UPDATE(YES)─┘ └─UPDATEMODEL(CONTENTION)─┘

|

CREATE JOURNALMODEL 55──CREATE JOURNALMODEL(data-value)────────────────────────────────────────5 5────ATTRIBUTES(data-value)ATTRLEN(data-value)────5%

Conditions: ILLOGIC, INVREQ, LENGERR, NOTAUTH

98

CICS User’s Handbook

SPI syntax

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

CREATE LSRPOOL 55──CREATE LSRPOOL(data-value)──ATTRIBUTES(data-value)─────────────────────5 5──ATTRLEN(data-value)──5%

Conditions: ILLOGIC, INVREQ, LENGERR, NOTAUTH

Chapter 2. SPI command syntax

99

SPI syntax

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

CREATE MAPSET 55──CREATE MAPSET(data-value)──────────────────────────────────────────────5 5────ATTRIBUTES(data-value)ATTRLEN(data-value)────5%

Conditions: ILLOGIC, INVREQ, LENGERR, NOTAUTH

100

CICS User’s Handbook

SPI syntax

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

CREATE PARTITIONSET 55──CREATE PARTITIONSET(data-value)────────────────────────────────────────5 5────ATTRIBUTES(data-value)ATTRLEN(data-value)────5%

Conditions: ILLOGIC, INVREQ, LENGERR, NOTAUTH

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

CREATE PARTNER 55──CREATE PARTNER(data-value)─────────────────────────────────────────────5 5────ATTRIBUTES(data-value)ATTRLEN(data-value)────5%

Conditions: ILLOGIC, INVREQ, LENGERR, NOTAUTH

Chapter 2. SPI command syntax

101

SPI syntax

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

CREATE PROCESSTYPE 55──CREATE PROCESSTYPE(data-value)──ATTRIBUTES(data-value)─────────────────5 5──ATTRLEN(data-value)──5%

Conditions: ILLOGIC, INVREQ, LENGERR, NOTAUTH

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

CREATE PROFILE 55──CREATE PROFILE(data-value)─────────────────────────────────────────────5 5────ATTRIBUTES(data-value)ATTRLEN(data-value)────5%

Conditions: ILLOGIC, INVREQ, LENGERR, NOTAUTH

102

CICS User’s Handbook

SPI syntax

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

CREATE PROGRAM 55──CREATE PROGRAM(data-value)─────────────────────────────────────────────5 5────ATTRIBUTES(data-value)ATTRLEN(data-value)────5%

Conditions: ILLOGIC, INVREQ, LENGERR, NOTAUTH

Chapter 2. SPI command syntax

103

SPI syntax

CREATE PROGRAM PROGRAM attributes: ┌─CEDF(YES)─┐ ┌─CONCURRENCY(QUASIRENT)──┐ ┌─DATALOCATION(BELOW)─┐ ├──┼───────────┼──┼─────────────────────────┼──┼─────────────────────┼─────5 └─CEDF(NO)──┘ └─CONCURRENCY(THREADSAFE)─┘ └─DATALOCATION(ANY)───┘ ┌─EXECKEY(USER)─┐ 5──┬─────────────────────┬──┼───────────────┼──────────────────────────────5 └─DESCRIPTION(char58)─┘ └─EXECKEY(CICS)─┘ |

┌─EXECUTIONSET(FULLAPI)───┐ ┌─JVM(NO)────┐ 5──┼─────────────────────────┼──┬───────────────────┬──┼────────────┼──────5 └─EXECUTIONSET(DPLSUBSET)─┘ └─JVMCLASS(char255)─┘ ├─JVM(DEBUG)─┤ └─JVM(YES)───┘

| |

┌─RELOAD(NO)──┐ 5──┬─────────────────────┬──┼─────────────┼────────────────────────────────5 ├─LANGUAGE(ASSEMBLER)─┤ └─RELOAD(YES)─┘ ├─LANGUAGE(C)─────────┤ ├─LANGUAGE(COBOL)─────┤ ├─LANGUAGE(LE37ð)─────┤ └─LANGUAGE(PLI)───────┘ ┌─RESIDENT(NO)──┐ 5──┬────────────────────────────────────────────┬──┼───────────────┼───────5 └─REMOTESYSTEM(char4)─┬───────────────────┬──┘ └─RESIDENT(YES)─┘ └─REMOTENAME(char8)─┘ ┌─STATUS(ENABLED)──┐ ┌─USAGE(NORMAL)────┐ 5──┼──────────────────┼──┬────────────────┬──┼──────────────────┼──────────5 └─STATUS(DISABLED)─┘ └─TRANSID(char4)─┘ └─USAGE(TRANSIENT)─┘ ┌─USELPACOPY(NO)──┐ 5──┼─────────────────┼──┤ └─USELPACOPY(YES)─┘

CREATE REQUESTMODEL 55──CREATE REQUESTMODEL(data-value)────────────────────────────────────────5 5────ATTRIBUTES(data-value)ATTRLEN(data-value)────5%

Conditions: ILLOGIC, INVREQ, LENGERR, NOTAUTH

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

104

CICS User’s Handbook

SPI syntax

CREATE SESSIONS 55──CREATE SESSIONS(data-value)────────────────────────────────────────────5 5────ATTRIBUTES(data-value)ATTRLEN(data-value)────5%

Conditions: ILLOGIC, INVREQ, LENGERR, NOTAUTH

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

Chapter 2. SPI command syntax

105

SPI syntax

CREATE TCPIPSERVICE 55──CREATE TCPIPSERVICE(data-value)────────────────────────────────────────5 5────ATTRIBUTES(data-value)ATTRLEN(data-value)────5%

Conditions: ILLOGIC, INVREQ, LENGERR, NOTAUTH

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

CREATE TDQUEUE 55──CREATE TDQUEUE(data-value)─────────────────────────────────────────────5 5────ATTRIBUTES(data-value)ATTRLEN(data-value)────5%

Conditions: ILLOGIC, INVREQ, LENGERR, NOTAUTH

106

CICS User’s Handbook

SPI syntax

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

Chapter 2. SPI command syntax

107

SPI syntax

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

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

108

CICS User’s Handbook

SPI syntax

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

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

Conditions: ILLOGIC, INVREQ, LENGERR, NOTAUTH

Chapter 2. SPI command syntax

109

SPI syntax

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

CREATE TRANCLASS 55──CREATE TRANCLASS(data-value)───────────────────────────────────────────5 5────ATTRIBUTES(data-value)ATTRLEN(data-value)────5%

Conditions: ILLOGIC, INVREQ, LENGERR, NOTAUTH

110

CICS User’s Handbook

SPI syntax

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

CREATE TRANSACTION 55──CREATE TRANSACTION(data-value)─────────────────────────────────────────5 5────ATTRIBUTES(data-value)ATTRLEN(data-value)────5%

Conditions: ILLOGIC, INVREQ, LENGERR, NOTAUTH

Chapter 2. SPI command syntax

111

SPI syntax

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

112

CICS User’s Handbook

SPI syntax

||

CREATE TSMODEL

|

55──CREATE TSMODEL(data-value)─────────────────────────────────────────────5

|

5────ATTRIBUTES(data-value)ATTRLEN(data-value)────5%

|

||

Conditions: ILLOGIC, INVREQ, LENGERR, NOTAUTH

CREATE TSMODEL

| | | |

TSMODEL attributes:

| | | |

┌─RECOVERY(NO)──┐ 5──┬─────────────────┬──┬─────────────────┬──┼───────────────┼─────────────5 └─POOLNAME(char8)─┘ ├─PREFIX(char16)──┤ └─RECOVERY(YES)─┘ └─XPREFIX(char32)─┘

| | | | |

┌─SECURITY(NO)──┐ 5──┬───────────────────────────────────────────────┬──┼───────────────┼──┤ └─REMOTESYSTEM(char4)─┬──────────────────────┬──┘ └─SECURITY(YES)─┘ ├─REMOTEPREFIX(char16)─┤ └─XREMOTEPFX(char32)───┘

┌─LOCATION(AUXILIARY)─┐ ├──┬─────────────────────┬──┼─────────────────────┼────────────────────────5 └─DESCRIPTION(char58)─┘ └─LOCATION(MAIN)──────┘

CREATE TYPETERM 55──CREATE TYPETERM(data-value)──ATTRIBUTES(data-value)────────────────────5 5──ATTRLEN(data-value)──5%

Conditions: ILLOGIC, INVREQ, LENGERR, NOTAUTH

Chapter 2. SPI command syntax

113

SPI syntax

CREATE TYPETERM

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

114

CICS User’s Handbook

SPI syntax

CREATE TYPETERM

TYPETERM attributes (2/3): ┌─LIGHTPEN(NO)──┐ ├──┬────────────────┬──┼───────────────┼──┬────────────────┬───────────────5 └─LDCLIST(char8)─┘ └─LIGHTPEN(YES)─┘ ├─LOGMODE(char8)─┤ └─LOGMODE(ð)─────┘ ┌─LOGONMSG(NO)──┐ ┌─MSRCONTROL(NO)──┐ ┌─NEPCLASS(ð)─────┐ 5──┼───────────────┼──┼─────────────────┼──┼─────────────────┼─────────────5 └─LOGONMSG(YES)─┘ └─MSRCONTROL(YES)─┘ └─NEPCLASS(ð-255)─┘ ┌─OBFORMAT(NO)──┐ ┌─OBOPERID(NO)──┐ ┌─OUTLINE(NO)──┐ 5──┼───────────────┼──┼───────────────┼──┼──────────────┼──────────────────5 └─OBFORMAT(YES)─┘ └─OBOPERID(YES)─┘ └─OUTLINE(YES)─┘ ┌─PAGESIZE(24,8ð)───────┐ ┌─PARTITIONS(NO)──┐ 5──┼───────────────────────┼──┼─────────────────┼──────────────────────────5 └─PAGESIZE(ð-999,ð-999)─┘ └─PARTITIONS(YES)─┘ ┌─PRINTADAPTER(NO)──┐ ┌─PROGSYMBOLS(NO)──┐ ┌─QUERY(NO)───┐ 5──┼───────────────────┼──┼──────────────────┼──┼─────────────┼────────────5 └─PRINTADAPTER(YES)─┘ └─PROGSYMBOLS(YES)─┘ ├─QUERY(ALL)──┤ └─QUERY(COLD)─┘ ┌─RECEIVESIZE(256)─────┐ ┌─RECOVNOTIFY(NONE)────────┐ 5──┼──────────────────────┼──┼──────────────────────────┼──────────────────5 └─RECEIVESIZE(ð-3ð72ð)─┘ ├─RECOVNOTIFY(MESSAGE)─────┤ └─RECOVNOTIFY(TRANSACTION)─┘ ┌─RECOVOPTION(SYSDEFAULT)──┐ ┌─RELREQ(NO)──┐ 5──┼──────────────────────────┼──┼─────────────┼───────────────────────────5 ├─RECOVOPTION(CLEARCONV)───┤ └─RELREQ(YES)─┘ ├─RECOVOPTION(NONE)────────┤ ├─RECOVOPTION(RELEASESESS)─┤ └─RECOVOPTION(UNCONDREL)───┘ ┌─SENDSIZE(ð)───────┐ 5──┬──────────────────────┬──┼───────────────────┼─────────────────────────5 ├─ROUTEDMSGS(ALL)──────┤ └─SENDSIZE(ð-3ð72ð)─┘ ├─ROUTEDMSGS(NONE)─────┤ └─ROUTEDMSGS(SPECIFIC)─┘ ┌─SHIPPABLE(NO)──┐ ┌─SIGNOFF(YES)────┐ 5──┬────────────────────┬──┼────────────────┼──┼─────────────────┼─────────5 └─SESSIONTYPE(char8)─┘ └─SHIPPABLE(YES)─┘ ├─SIGNOFF(NO)─────┤ └─SIGNOFF(LOGOFF)─┘ ┌─SOSI(NO)──┐ ┌─TEXTKYBD(NO)──┐ 5──┼───────────┼──┬──────────────┬──┼───────────────┼──────────────────────5 └─SOSI(YES)─┘ ├─TERMMODEL(1)─┤ └─TEXTKYBD(YES)─┘ └─TERMMODEL(2)─┘ ┌─TEXTPRINT(NO)──┐ ┌─TTI(YES)─┐ ┌─UCTRAN(NO)─────┐ 5──┼────────────────┼──┼──────────┼──┼────────────────┼────────────────────5 └─TEXTPRINT(YES)─┘ └─TTI(NO)──┘ ├─UCTRAN(TRANID)─┤ └─UCTRAN(YES)────┘ ┌─USERAREALEN(ð)─────┐ ┌─VALIDATION(NO)──┐ 5──┼────────────────────┼──┼─────────────────┼──┤ └─USERAREALEN(ð-255)─┘ └─VALIDATION(YES)─┘

Chapter 2. SPI command syntax

115

SPI syntax

CREATE TYPETERM

TYPETERM attributes (3/3): ┌─VERTICALFORM(NO)──┐ ┌─XRFSIGNOFF(NOFORCE)─┐ ├──┼───────────────────┼──┼─────────────────────┼──┤ └─VERTICALFORM(YES)─┘ └─XRFSIGNOFF(FORCE)───┘

DISABLE PROGRAM 55──DISABLE PROGRAM(data-value)──┬───────────────────────┬─────────────────5 └─ENTRYNAME(data-value)─┘ 5──┬──────────────────┬───┬───────────┬────┬──────────┬────┬─────┬─────────5 ├─EXIT(data-value)─┤ └─FORMATEDF─┘ └─SHUTDOWN─┘ └─SPI─┘ └─EXITALL──────────┘ 5───┬──────┬────┬───────────┬───5% └─STOP─┘ └─TASKSTART─┘

Conditions: INVEXITREQ, NOTAUTH

DISCARD AUTINSTMODEL 55──DISCARD AUTINSTMODEL(data-value)──5%

Conditions: INVREQ, MODELIDERR, NOTAUTH

DISCARD CONNECTION 55──DISCARD CONNECTION(data-value)──5%

Conditions: INVREQ, NOTAUTH, SYSIDERR

DISCARD DB2CONN 55──DISCARD DB2CONN──5%

Conditions: INVREQ, NOTAUTH, NOTFND

116

CICS User’s Handbook

SPI syntax

DISCARD DB2ENTRY 55──DISCARD DB2ENTRY(data-value)──5%

Conditions: NOTFND, INVREQ, NOTAUTH

DISCARD DB2TRAN 55──DISCARD DB2TRAN(data-value)──5%

Conditions: NOTFND, NOTAUTH

DISCARD DOCTEMPLATE 55──DISCARD DOCTEMPLATE(data-value)──5%

Conditions: NOTAUTH, NOTFND

||

DISCARD ENQMODEL

|

55──DISCARD ENQMODEL(data-value)──5%

|

Conditions: NOTAUTH, NOTFND

DISCARD FILE 55──DISCARD FILE(data-value)──5%

Conditions: FILENOTFOUND, INVREQ, NOTAUTH

Chapter 2. SPI command syntax

117

SPI syntax

DISCARD JOURNALMODEL 55──DISCARD──JOURNALMODEL(data-value)──5%

Conditions: NOTAUTH, NOTFND

DISCARD JOURNALNAME 55──DISCARD──JOURNALNAME(data-value)──5%

Conditions: INVREQ, JIDERR, NOTAUTH

DISCARD PARTNER 55──DISCARD PARTNER(data-value)──5%

Conditions: INVREQ, NOTAUTH, PARTNERIDERR

DISCARD PROCESSTYPE 55──DISCARD──PROCESSTYPE(data-value)──5%

Conditions: INVREQ, NOTAUTH, PROCESSERR

DISCARD PROFILE 55──DISCARD PROFILE(data-value)──5%

Conditions: INVREQ, NOTAUTH, PROFILEIDERR

118

CICS User’s Handbook

SPI syntax

DISCARD PROGRAM 55──DISCARD PROGRAM(data-value)──5%

Conditions: INVREQ, NOTAUTH, PGMIDERR

DISCARD REQUESTMODEL 55──DISCARD──REQUESTMODEL(data-value)──5%

Conditions: NOTAUTH, NOTFND

DISCARD TCPIPSERVICE 55──DISCARD TCPIPSERVICE(data-value)──5%

Conditions: INVREQ, NOTAUTH, NOTFND

DISCARD TDQUEUE 55──DISCARD TDQUEUE(data-value)──5%

Conditions: INVREQ, NOTAUTH, QIDERR

DISCARD TERMINAL 55──DISCARD TERMINAL(data-value)──5%

Conditions: INVREQ, NOTAUTH, TERMIDERR

Chapter 2. SPI command syntax

119

SPI syntax

DISCARD TRANCLASS 55──DISCARD TRANCLASS(data-value)──5%

Conditions: INVREQ, NOTAUTH, TCIDERR

DISCARD TRANSACTION 55──DISCARD TRANSACTION(data-value)──5%

Conditions: INVREQ, NOTAUTH, TRANSIDERR

||

DISCARD TSMODEL

|

|

55──DISCARD TSMODEL(data-value)──5%

Conditions: INVREQ, NOTAUTH, NOTFND

ENABLE PROGRAM ┌── ───────────────────────────────┐ 55──ENABLE PROGRAM(data-value)───6┬─────────────────────────────┬┴──5% ├─ENTRY(ptr-ref)──────────────┤ ├─ENTRYNAME(data-value)───────┤ ├─EXIT(data-value)────────────┤ ├─FORMATEDF───────────────────┤ ├─┬─GALENGTH(data-value)────┬─┤ │ └─GAENTRYNAME(data-value)─┘ │ ├─INDOUBTWAIT─────────────────┤ ├─LINKEDITMODE────────────────┤ ├─┬─QUASIRENT───────────────┬─┤ │ ├─THREADSAFE──┬─────────┬─┤ │ │ │ └─OPENAPI─┘ │ │ │ └─OPENAPI─────────────────┘ │ ├─SHUTDOWN────────────────────┤ ├─SPI─────────────────────────┤ ├─START───────────────────────┤ ├─TALENGTH(data-value)────────┤ └─TASKSTART───────────────────┘

| | | |

Conditions: INVEXITREQ, NOTAUTH

120

CICS User’s Handbook

SPI syntax

EXTRACT EXIT 55──EXTRACT EXIT PROGRAM(data-value)──┬───────────────────────┬────────────5 └─ENTRYNAME(data-value)─┘ 5──GALENGTH(data-area)──GASET(ptr-ref)──5%

Conditions: INVEXITREQ, NOTAUTH

INQUIRE AUTINSTMODEL 55──INQUIRE AUTINSTMODEL(data-value)──5%

Conditions: END, ILLOGIC, MODELIDERR, NOTAUTH

INQUIRE AUTOINSTALL |

|

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

Conditions: NOTAUTH

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

Conditions: END, ILLOGIC, NOTAUTH, POOLERR

Chapter 2. SPI command syntax

121

SPI syntax

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

|

Conditions: END, ILLOGIC, NOTAUTH, SYSIDERR

122

CICS User’s Handbook

SPI syntax

INQUIRE DB2CONN 55──INQUIRE DB2CONN────────────────────────────────────────────────────────5 ┌── ───────────────────────────┐ ┌── ───────────────────────────┐ 5───6┬─────────────────────────┬┴───6┬─────────────────────────┬┴──5% ├─┬─ACCOUNTREC(cvda)─┬────┤ ├─DB2ID(data-area)────────┤ │ ├─UOW──────────────┤ │ ├─DB2RELEASE(data-area)───┤ │ ├─TASK─────────────┤ │ ├─┬─DROLLBACK(cvda)─┬─────┤ │ ├─TXID─────────────┤ │ │ ├─ROLLBACK────────┤ │ │ └─NONE─────────────┘ │ │ └─NOROLLBACK──────┘ │ ├─AUTHID(data-area)───────┤ ├─MSGQUEUE1(data-area)────┤ ├─┬─AUTHTYPE(cvda)─┬──────┤ ├─MSGQUEUE2(data-area)────┤ │ ├─GROUP──────────┤ │ ├─MSGQUEUE3(data-area)────┤ │ ├─SIGN───────────┤ │ ├─┬─NONTERMREL(cvda)─┬────┤ │ ├─TERM───────────┤ │ │ ├─RELEASE──────────┤ │ │ ├─TX─────────────┤ │ │ └─NORELEASE────────┘ │ │ ├─OPID───────────┤ │ ├─PLAN(data-area)─────────┤ │ └─USERID─────────┘ │ ├─PLANEXITNAME(data-area)─┤ ├─COMAUTHID(data-area)────┤ ├─┬─PRIORITY(cvda)─┬──────┤ ├─┬─COMAUTHTYPE(cvda)─┬───┤ │ ├─HIGH───────────┤ │ │ ├─CGROUP────────────┤ │ │ ├─EQUAL──────────┤ │ │ ├─CSIGN─────────────┤ │ │ └─LOW────────────┘ │ │ ├─CTERM─────────────┤ │ ├─PURGECYCLEM(data-area)──┤ │ ├─CTX───────────────┤ │ ├─PURGECYCLES(data-area)──┤ │ ├─COPID─────────────┤ │ ├─SIGNID(data-area)───────┤ │ └─CUSERID───────────┘ │ ├─┬─STANDBYMODE(cvda)─┬───┤ ├─COMTHREADLIM(data-area)─┤ │ ├─NOCONNECT─────────┤ │ ├─COMTHREADS(data-area)───┤ │ ├─CONNECT───────────┤ │ ├─┬─CONNECTERROR(cvda)─┬──┤ │ └─RECONNECT─────────┘ │ │ ├─ABEND──────────────┤ │ ├─STATSQUEUE(data-area)───┤ │ └─SQLCODE────────────┘ │ ├─TCBLIMIT(data-area)─────┤ └─┬─CONNECTST(cvda)─┬─────┘ ├─TCBs(data-area)─────────┤ ├─CONNECTED───────┤ ├─THREADS(data-area)──────┤ ├─CONNECTING──────┤ ├─┬─THREADERROR(cvda)─┬───┤ ├─DISCONNING──────┤ │ ├─ABEND─────────────┤ │ └─NOTCONNECTED────┘ │ ├─N9ð6D─────────────┤ │ │ └─N9ð6──────────────┘ │ ├─THREADLIMIT(data-area)──┤ └─┬─THREADWAIT(cvda)─┬────┘ ├─TWAIT────────────┤ └─NOTWAIT──────────┘

Conditions: NOTAUTH, NOTFND

Chapter 2. SPI command syntax

123

SPI syntax

INQUIRE DB2ENTRY 55──INQUIRE DB2ENTRY(data-value)──┬──────────────────┬─────────────────────5 ├─ACCOUNTREC(cvda)─┤ ├─UOW──────────────┤ ├─TASK─────────────┤ ├─TXID─────────────┤ └─NONE─────────────┘ 5──┬───────────────────┬──┬────────────────┬──┬───────────────────┬────────5 └─AUTHID(data-area)─┘ ├─AUTHTYPE(cvda)─┤ ├─DISABLEDACT(cvda)─┤ ├─GROUP──────────┤ ├─ABEND─────────────┤ ├─SIGN───────────┤ ├─SQLCODE───────────┤ ├─TERM───────────┤ └─POOL──────────────┘ ├─TX─────────────┤ ├─OPID───────────┤ └─USERID─────────┘ 5──┬─────────────────┬──┬────────────────────┬──┬─────────────────┬────────5 ├─DROLLBACK(cvda)─┤ ├─ENABLESTATUS(cvda)─┤ └─PLAN(data-area)─┘ ├─ROLLBACK────────┤ ├─ENABLED────────────┤ └─NOROLLBACK──────┘ ├─DISABLED───────────┤ └─DISABLING──────────┘ 5──┬─────────────────────────┬──┬────────────────┬─────────────────────────5 └─PLANEXITNAME(data-area)─┘ ├─PRIORITY(cvda)─┤ ├─HIGH───────────┤ ├─EQUAL──────────┤ └─LOW────────────┘ 5──┬───────────────────────┬──┬─────────────────────┬──────────────────────5 └─PROTECTNUM(data-area)─┘ └─PTHREADS(data-area)─┘ 5──┬────────────────────────┬──┬────────────────────┬──────────────────────5 └─THREADLIMIT(data-area)─┘ └─THREADS(data-area)─┘ 5──┬──────────────────┬──5% ├─THREADWAIT(cvda)─┤ ├─TWAIT────────────┤ ├─NOTWAIT──────────┤ └─TPOOL────────────┘

Conditions: END,ILLOGIC,NOTAUTH, NOTFND

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

Conditions: END,ILLOGIC,NOTAUTH, NOTFND

124

CICS User’s Handbook

SPI syntax

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

Conditions: NOTAUTH

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

Conditions: END, ILLOGIC, NOTFND, NOTAUTH

Chapter 2. SPI command syntax

125

SPI syntax

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

Conditions: DSNNOTFOUND, END, ILLOGIC, IOERR, NOTAUTH

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

Conditions: NOTAUTH

126

CICS User’s Handbook

SPI syntax

||

INQUIRE ENQ

| | |

55──INQUIRE ENQ──┬─ENQSCOPE(data-value)───────────────────┬────────────────5 ├─RESOURCE(data-value)RESLEN(data-value)─┤ └─UOW(data-value)────────────────────────┘

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

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

|

|| | | | | |

|

Conditions: END, ILLOGIC, NOTAUTH, UOWNOTFOUND

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

Conditions: END, ILLOGIC, NOTAUTH, NOTFND

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

Conditions: END, ILLOGIC, NOTAUTH

Chapter 2. SPI command syntax

127

SPI syntax

INQUIRE EXITPROGRAM ┌── ────────────────────────────┐ 55──INQUIRE EXITPROGRAM(data-value)───6┬──────────────────────────┬┴──5% ├─EXIT(data-value)─────────┤ ├─ENTRYNAME(data-value)────┤ ├─APIST(data-value)────────┤ ├─CONCURRENTST(data-value)─┤ ├─CONNECTST(cvda)──────────┤ ├─ENTRY(data-area)─────────┤ ├─FORMATEDFST(cvda)────────┤ ├─GAENTRYNAME(data-area)───┤ ├─GALENGTH(data-area)──────┤ ├─GAUSECOUNT(data-area)────┤ ├─INDOUBTST(cvda)──────────┤ ├─NUMEXITS(data-area)──────┤ ├─QUALIFIER(data-area)─────┤ ├─SHUTDOWNST(cvda)─────────┤ ├─SPIST(cvda)──────────────┤ ├─STARTSTATUS(cvda)────────┤ ├─TALENGTH(data-area)──────┤ └─TASKSTARTST(cvda)────────┘

| |

Conditions: END, ILLOGIC, INVREQ, NOTAUTH, PGMIDERR

128

CICS User’s Handbook

SPI syntax

INQUIRE FILE

|

|

|

| |

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

Conditions: END, FILENOTFOUND, ILLOGIC, NOTAUTH

INQUIRE IRC 55──INQUIRE IRC──┬──────────────────┬──5% └─OPENSTATUS(cvda)─┘

Conditions: NOTAUTH

Chapter 2. SPI command syntax

129

SPI syntax

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

Conditions: END, ILLOGIC, NOTAUTH, NOTFND

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

Conditions: END, ILLOGIC, JIDERR, NOTAUTH

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

Conditions: END, ILLOGIC, NOTAUTH, SYSIDERR

130

CICS User’s Handbook

SPI syntax

INQUIRE MONITOR ┌── ───────────────────────────────────────────────┐ 55──INQUIRE MONITOR───6┬─────────────────────────────────────────────┬┴──5% ├─CONVERSEST(cvda)────────────────────────────┤ ├─EVENTCLASS(cvda)────────────────────────────┤ ├─EXCEPTCLASS(cvda)───────────────────────────┤ ├─┬─FREQUENCY(data-area)────────────────────┬─┤ │ └─┤ freqhrs ├──┤ freqmins ├──┤ freqsecs ├─┘ │ ├─PERFCLASS(cvda)─────────────────────────────┤ ├─STATUS(cvda)────────────────────────────────┤ ├─SUBSYSTEMID(data-area)──────────────────────┤ ├─SYNCPOINTST(cvda)───────────────────────────┤ └─TIME(cvda)──────────────────────────────────┘ freqhrs: ├──FREQUENCYHRS(data-area)──┤ freqmins: ├──FREQUENCYMIN(data-area)──┤ freqsecs: ├──FREQUENCYSEC(data-area)──┤

Conditions: NOTAUTH

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

Conditions: NOTAUTH, TERMIDERR

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

Conditions: END, ILLOGIC, NOTAUTH, PARTNERIDERR

Chapter 2. SPI command syntax

131

SPI syntax

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

Conditions: NOTAUTH, PROCESSERR

INQUIRE PROFILE 55──INQUIRE PROFILE(data-value)──5%

Conditions: END, ILLOGIC, NOTAUTH, PROFILEIDERR

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

| |

| |

|

Conditions: END, ILLOGIC, NOTAUTH, PGMIDERR

132

CICS User’s Handbook

SPI syntax

INQUIRE REQID 55──INQUIRE REQID(data-value)──┬───────────────┬───────────────────────────5 └─REQTYPE(cvda)─┘ 5──┬───────────────────┬──┬────────────────────┬───────────────────────────5 └─TERMID(data-area)─┘ └─TRANSID(data-area)─┘ 5──┬─────────────────────────────────────────────────────────────────┬─────5 ├─INTERVAL(data-area)─────────────────────────────────────────────┤ ├─TIME(data-area)─────────────────────────────────────────────────┤ ├─AFTER──HOURS(data-area)──MINUTES(data-area)──SECONDS(data-area)─┤ └─AT──HOURS(data-area)──MINUTES(data-area)──SECONDS(data-area)────┘ 5──┬──────────────────────────────────────────────────────┬────────────────5 └─SET(ptr-ref)──LENGTH(data-area)──┬─────────────────┬─┘ └─FMHSTATUS(cvda)─┘ 5──┬─────────────────────┬──┬────────────────────┬─────────────────────────5 └─RTRANSID(data-area)─┘ └─RTERMID(data-area)─┘ 5──┬──────────────────┬──┬───────────────────┬──5% └─QUEUE(data-area)─┘ └─USERID(data-area)─┘

Conditions: END, ILLOGIC, INVREQ, NOTAUTH, NOTFND

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

Conditions: END, ILLOGIC, JIDERR, NOTAUTH

INQUIRE RRMS 55──INQUIRE RRMS──┬──────────────────┬──5% └─OPENSTATUS(cvda)─┘

Conditions:

Chapter 2. SPI command syntax

133

SPI syntax

INQUIRE STATISTICS 55──INQUIRE STATISTICS──┬──────────────────────────────────────┬───────────5 ├─ENDOFDAY(data-area)──────────────────┤ └─┤ endhrs ├──┤ endmins ├──┤ endsecs ├─┘ 5──┬───────────────────────────────────┬───────────────────────────────────5 ├─INTERVAL(data-area)───────────────┤ └─┤ inhrs ├──┤ inmins ├──┤ insecs ├─┘ 5──┬───────────────────────────────────┬──┬─────────────────┬──5% ├─NEXTTIME(data-area)───────────────┤ └─RECORDING(cvda)─┘ └─┤ nxhrs ├──┤ nxmins ├──┤ nxsecs ├─┘ endhrs: ├──ENDOFDAYHRS(data-area)──┤ endmins: ├──ENDOFDAYMINS(data-area)──┤ endsecs: ├──ENDOFDAYSECS(data-area)──┤ inhrs: ├──INTERVALHRS(data-area)──┤ inmins: ├──INTERVALMINS(data-area)──┤ insecs: ├──INTERVALSECS(data-area)──┤ nxhrs: ├──NEXTTIMEHRS(data-area)──┤ nxmins: ├──NEXTTIMEMINS(data-area)──┤ nxsecs: ├──NEXTTIMESECS(data-area)──┤

Conditions: NOTAUTH

134

CICS User’s Handbook

SPI syntax

INQUIRE STORAGE 55──INQUIRE STORAGE────────────────────────────────────────────────────────5 5──┬─ADDRESS(ptr-value)──┬──────────────────┬──┬────────────────────┬─┬──5% │ └─ELEMENT(ptr-ref)─┘ └─FLENGTH(data-area)─┘ │ └─NUMELEMENTS(data-area)──┤ elist ├──┤ llist ├──┤ task ├───────────┘ elist: ├──┬──────────────────────┬──┤ └─ELEMENTLIST(ptr-ref)─┘ llist: ├──┬─────────────────────┬──┤ └─LENGTHLIST(ptr-ref)─┘ task: ├──┬──────────────────┬──┤ └─TASK(data-value)─┘

Conditions: NOTAUTH, TASKIDERR

INQUIRE STREAMNAME ┌── ───────────────────────┐ 55──INQUIRE STREAMNAME(data-value)───6┬─────────────────────┬┴──5% ├─STATUS(cvda)────────┤ ├─SYSTEMLOG(cvda)─────┤ └─USECOUNT(data-area)─┘

Conditions: END, ILLOGIC, NOTAUTH, NOTFND

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

Conditions: END, ILLOGIC, NOTAUTH, NOTFND

Chapter 2. SPI command syntax

135

SPI syntax

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

|

|

|

| |

|

Condition: NOTAUTH

136

CICS User’s Handbook

SPI syntax

INQUIRE TASK | |

| |

|

┌── ───────────────────────────────┐ 55──INQUIRE TASK(data-value)───6┬─────────────────────────────┬┴──5% ├─ACTIVITY(data-area)─────────┤ ├─ACTIVITYID(data-area)───────┤ ├─ATTACHTIME(data-area)───────┤ ├─BRIDGE(data-area)───────────┤ ├─CMDSEC(cvda)────────────────┤ ├─DB2PLAN(data-area)──────────┤ ├─DTIMEOUT(data-area)─────────┤ ├─DUMPING(cvda)───────────────┤ ├─FACILITY(data-area)─────────┤ ├─FACILITYTYPE(cvda)──────────┤ ├─IDENTIFIER(data-area)───────┤ ├─INDOUBT(cvda)───────────────┤ ├─INDOUBTMINS(data-area)──────┤ ├─INDOUBTWAIT(cvda)───────────┤ ├─ISOLATEST(cvda)─────────────┤ ├─PRIORITY(data-area)─────────┤ ├─PROCESS(data-area)──────────┤ ├─PROCESSTYPE(data-area)──────┤ ├─PROFILE(data-area)──────────┤ ├─PROGRAM(data-area)──────────┤ ├─PURGEABILITY(cvda)──────────┤ ├─REMOTENAME(data-area)───────┤ ├─REMOTESYSTEM(data-area)─────┤ ├─RESSEC(cvda)────────────────┤ ├─ROUTING(cvda)───────────────┤ ├─RTIMEOUT(data-area)─────────┤ ├─RUNAWAY(data-area)──────────┤ ├─RUNSTATUS(cvda)─────────────┤ ├─SCRNSIZE(cvda)──────────────┤ ├─STARTCODE(data-area)────────┤ ├─STORAGECLEAR(cvda)──────────┤ ├─SUSPENDTIME(data-area)──────┤ ├─SUSPENDTYPE(data-area)──────┤ ├─┬─SUSPENDVALUE(data-area)─┬─┤ │ └─RESNAME(data-area)──────┘ │ ├─TASKDATAKEY(cvda)───────────┤ ├─TASKDATALOC(cvda)───────────┤ ├─TCB(cvda)───────────────────┤ ├─┬─TRANCLASS(data-area)─┬────┤ │ └─TCLASS(data-area)────┘ │ ├─TRACING(cvda)───────────────┤ ├─TRANPRIORITY(data-area)─────┤ ├─TRANSACTION(data-area)──────┤ ├─TRPROF(data-area)───────────┤ ├─TWASIZE(data-area)──────────┤ ├─UOW(data-area)──────────────┤ └─USERID(data-area)───────────┘

Conditions: NOTAUTH, TASKIDERR

Chapter 2. SPI command syntax

137

SPI syntax

INQUIRE TASK LIST 55──INQUIRE TASK LIST──LISTSIZE(data-area)───┬──────────────┬──────────────5 └─DISPATCHABLE─┘ 5───┬─────────┬────┬───────────┬───────────────────────────────────────────5 └─RUNNING─┘ └─SUSPENDED─┘ 5──┬───────────────────────────────────────┬──5% └─SET(ptr-ref)──┬─────────────────────┬─┘ └─SETTRANSID(ptr-ref)─┘

Condition: NOTAUTH

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

Conditions: NOTAUTH, TCIDERR

INQUIRE TCPIP 55──INQUIRE

TCPIP──OPENSTATUS(cvda)──5%

Conditions: INVREQ, NOTAUTH

138

CICS User’s Handbook

SPI syntax

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

Conditions: INVREQ, NOTAUTH , NOTFND

INQUIRE TDQUEUE

|

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

Conditions: ENDCOND, ILLOGIC, NORMAL, NOTAUTH, QIDERR

Chapter 2. SPI command syntax

139

SPI syntax

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

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

INQUIRE TERMINAL ┌── ─────────────────────────┐ 55───6┬───────────────────────┬┴──5% ├─ACCESSMETHOD(cvda)────┤ ├─ACQSTATUS(cvda)───────┤ ├─ALTPAGEHT(data-area)──┤ ├─ALTPAGEWD(data-area)──┤ ├─ALTPRINTER(data-area)─┤ ├─ALTPRTCOPYST(cvda)────┤ ├─ALTSCRNHT(data-area)──┤ ├─ALTSCRNWD(data-area)──┤ ├─ALTSUFFIX(data-area)──┤ ├─APLKYBDST(cvda)───────┤ ├─APLTEXTST(cvda)───────┤ ├─ASCII(cvda)───────────┤ ├─ATISTATUS(cvda)───────┤ ├─AUDALARMST(cvda)──────┤ ├─AUTOCONNECT(cvda)─────┤ ├─BACKTRANSST(cvda)─────┤ ├─COLORST(cvda)─────────┤ ├─CONSOLE(data-area)────┤ ├─COPYST(cvda)──────────┤ ├─CORRELID(data-area)───┤ ├─CREATESESS(cvda)──────┤ ├─DATASTREAM(cvda)──────┤ ├─DEFPAGEHT(data-area)──┤ ├─DEFPAGEWD(data-area)──┤ ├─DEFSCRNHT(data-area)──┤ ├─DEFSCRNWD(data-area)──┤ ├─DEVICE(cvda)──────────┤ ├─DISCREQST(cvda)───────┤ ├─DUALCASEST(cvda)──────┤ ├─EXITTRACING(cvda)─────┤ ├─EXTENDEDDSST(cvda)────┤ ├─FMHPARMST(cvda)───────┤ ├─FORMFEEDST(cvda)──────┤ ├─GCHARS(data-area)─────┤ ├─GCODES(data-area)─────┤ ├─HFORMST(cvda)─────────┤ ├─HILIGHTST(cvda)───────┤ ├─KATAKANAST(cvda)──────┤ ├─LIGHTPENST(cvda)──────┤ ├─LINKSYSTEM(data-area)─┤ ├─MAPNAME(data-area)────┤ └─MAPSETNAME(data-area)─┘

|

140

CICS User’s Handbook

SPI syntax

INQUIRE TERMINAL ┌── ───────────────────────────┐ 55───6┬─────────────────────────┬┴──5% ├─MODENAME(data-area)─────┤ ├─MSRCONTROLST(cvda)──────┤ ├─NATLANG(data-area)──────┤ ├─NATURE(cvda)────────────┤ ├─NEXTTRANSID(data-area)──┤ ├─OBFORMATST(cvda)────────┤ ├─OBOPERIDST(cvda)────────┤ ├─OPERID(data-area)───────┤ ├─OUTLINEST(cvda)─────────┤ ├─PAGEHT(data-area)───────┤ ├─PAGESTATUS(cvda)────────┤ ├─PAGEWD(data-area)───────┤ ├─PARTITIONSST(cvda)──────┤ ├─PRINTADAPTST(cvda)──────┤ ├─PRINTER(data-area)──────┤ ├─PROGSYMBOLST(cvda)──────┤ ├─PRTCOPYST(cvda)─────────┤ ├─QUERYST(cvda)───────────┤ ├─RELREQST(cvda)──────────┤ ├─REMOTENAME(data-area)───┤ ├─REMOTESYSNET(data-area)─┤ ├─REMOTESYSTEM(data-area)─┤ ├─SCRNHT(data-area)───────┤ ├─SCRNWD(data-area)───────┤ ├─SECURITY(cvda)──────────┤ ├─SERVSTATUS(cvda)────────┤ ├─SESSIONTYPE(cvda)───────┤ ├─SIGNONSTATUS(cvda)──────┤ ├─SOSIST(cvda)────────────┤ ├─TASKID(data-area)───────┤ ├─TCAMCONTROL(data-area)──┤ ├─TERMMODEL(data-area)────┤ ├─TERMPRIORITY(data-area)─┤ ├─TERMSTATUS(cvda)────────┤ ├─TEXTKYBDST(cvda)────────┤ ├─TEXTPRINTST(cvda)───────┤ ├─TRACING(cvda)───────────┤ ├─TRANSACTION(data-area)──┤ ├─TTISTATUS(cvda)─────────┤ ├─UCTRANST(cvda)──────────┤ ├─USERAREA(ptr-ref)───────┤ ├─USERAREALEN(data-area)──┤ ├─USERID(data-area)───────┤ ├─USERNAME(data-area)─────┤ ├─VALIDATIONST(cvda)──────┤ ├─VFORMST(cvda)───────────┤ └─ZCPTRACING(cvda)────────┘

Conditions: END, ILLOGIC, NOTAUTH, TERMIDERR

Chapter 2. SPI command syntax

141

SPI syntax

INQUIRE TRACEDEST ┌── ────────────────────────┐ 55──INQUIRE TRACEDEST───6┬──────────────────────┬┴──5% ├─AUXSTATUS(cvda)──────┤ ├─CURAUXDS(data-area)──┤ ├─GTFSTATUS(cvda)──────┤ ├─INTSTATUS(cvda)──────┤ ├─SWITCHSTATUS(cvda)───┤ └─TABLESIZE(data-area)─┘

Conditions: NOTAUTH

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

Conditions: NOTAUTH

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

Conditions: NOTAUTH, NOTFND

INQUIRE TRANCLASS ┌── ──────────────────────────┐ 55──INQUIRE TRANCLASS(data-value)───6┬────────────────────────┬┴──5% ├─ACTIVE(data-area)──────┤ ├─MAXACTIVE(data-area)───┤ ├─PURGETHRESH(data-area)─┤ └─QUEUED(data-area)──────┘

Conditions: INVREQ, NOTAUTH, TCIDERR

142

CICS User’s Handbook

SPI syntax

INQUIRE TRANDUMPCODE ┌── ──────────────────────┐ 55──INQUIRE TRANDUMPCODE(data-value)───6┬────────────────────┬┴──5% ├─CURRENT(data-area)─┤ ├─DUMPSCOPE(cvda)────┤ ├─MAXIMUM(data-area)─┤ ├─SHUTOPTION(cvda)───┤ ├─SYSDUMPING(cvda)───┤ └─TRANDUMPING(cvda)──┘

Conditions: END, ILLOGIC, NOTAUTH, NOTFND

INQUIRE TRANSACTION

|

┌── ────────────────────────────┐ 55──INQUIRE TRANSACTION(data-value)───6┬──────────────────────────┬┴──5% ├─BREXIT(data-area)────────┤ ├─CMDSEC(cvda)─────────────┤ ├─DTIMEOUT(data-area)──────┤ ├─DUMPING(cvda)────────────┤ ├─FACILITYLIKE(data-area)──┤ ├─INDOUBT(cvda)────────────┤ ├─INDOUBTMINS(data-area)───┤ ├─INDOUBTWAIT(cvda)────────┤ ├─ISOLATEST(cvda)──────────┤ ├─PRIORITY(data-area)──────┤ ├─PROFILE(data-area)───────┤ ├─PROGRAM(data-area)───────┤ ├─PURGEABILITY(cvda)───────┤ ├─REMOTENAME(data-area)────┤ ├─REMOTESYSTEM(data-area)──┤ ├─RESSEC(cvda)─────────────┤ ├─ROUTING(cvda)────────────┤ ├─ROUTESTATUS(cvda)────────┤ ├─RTIMEOUT(data-area)──────┤ ├─RUNAWAY(data-area)───────┤ ├─RUNAWAYTYPE(cvda)────────┤ ├─SCRNSIZE(cvda)───────────┤ ├─SHUTDOWN(cvda)───────────┤ ├─STATUS(cvda)─────────────┤ ├─STORAGECLEAR(cvda)───────┤ ├─TASKDATAKEY(cvda)────────┤ ├─TASKDATALOC(cvda)────────┤ ├─┬─TCLASS(data-area)────┬─┤ │ └─TRANCLASS(data-area)─┘ │ ├─TRACING(cvda)────────────┤ ├─TRPROF(data-area)────────┤ └─TWASIZE(data-area)───────┘

Conditions: END, ILLOGIC, INVREQ, NOTAUTH, TRANSIDERR

Chapter 2. SPI command syntax

143

SPI syntax

||

INQUIRE TSMODEL

| | | | | | | | |

|

┌── ───────────────────────────┐ 55──INQUIRE ──TSMODEL(data-value)───6┬─────────────────────────┬┴──5% ├─LOCATION(cvda)──────────┤ ├─POOLNAME(data-area)─────┤ ├─PREFIX(data-area)───────┤ ├─RECOVSTATUS(cvda)───────┤ ├─REMOTEPREFIX(data-area)─┤ ├─REMOTESYSTEM(data-area)─┤ └─SECURITYST(cvda)────────┘

Conditions: END, ILLOGIC, NOTAUTH, NOTFND

||

INQUIRE TSPOOL

| |

|

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

Conditions: END, ILLOGIC, NOTAUTH, NOTFND

INQUIRE TSQUEUE 55──INQUIRE ──┬─TSQUEUE(data-value)─┬──┬──────────────────────┬────────────5 └─TSQNAME(data-value)─┘ ├─POOLNAME(data-value)─┤ └─SYSID(data-value)────┘

| |

┌── ──────────────────────────┐ 5───6┬────────────────────────┬┴──5% ├─FLENGTH(data-area)─────┤ ├─LASTUSEDINT(data-area)─┤ ├─LOCATION(cvda)─────────┤ ├─MAXITEMLEN(data-area)──┤ ├─MINITEMLEN(data-area)──┤ ├─NUMITEMS(data-area)────┤ ├─RECOVSTATUS(cvda)──────┤ └─TRANSID(data-area)─────┘

|

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

144

CICS User’s Handbook

SPI syntax

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

Conditions: END, ILLOGIC, NOTAUTH, UOWNOTFOUND

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

Conditions: END, ILLOGIC, NOTAUTH

Chapter 2. SPI command syntax

145

SPI syntax

INQUIRE UOWENQ |

┌── ──────────────────────────────────────────┐ 55──INQUIRE UOWENQ───6┬────────────────────────────────────────┬┴───────────5 ├─ENQSCOPE(data-value)───────────────────┤ ├─RESOURCE(data-value)RESLEN(data-value)─┤ └─UOW(data-value)────────────────────────┘

| | |

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

|

Conditions: END, ILLOGIC, NOTAUTH, UOWNOTFOUND

INQUIRE UOWLINK 55──INQUIRE UOWLINK(data-area)──┬─────────────────┬────────────────────────5 └─LINK(data-area)─┘ 5──┬─────────────────────┬──┬────────────────┬──┬────────────────────┬─────5 └─NETUOWID(data-area)─┘ ├─PROTOCOL(cvda)─┤ ├─RESYNCSTATUS(cvda)─┤ ├─APPC───────────┤ ├─COLD───────────────┤ ├─IRC────────────┤ ├─NOTAPPLIC──────────┤ ├─LU61───────────┤ ├─OK─────────────────┤ ├─NOTAPPLIC──────┤ ├─STARTING───────────┤ └─RRMS───────────┘ ├─UNAVAILABLE────────┤ └─UNCONNECTED────────┘

|

5──┬───────────────────┬──┬─────────────┬──┬──────────────────┬────────────5 └─RMIQFY(data-area)─┘ ├─ROLE(cvda)──┤ └─SYSID(data-area)─┘ ├─COORDINATOR─┤ ├─SUBORDINATE─┤ └─UNKNOWN─────┘ 5──┬────────────┬──┬────────────────┬──┬─────────────────┬──5% ├─TYPE(cvda)─┤ └─UOW(data-area)─┘ └─URID(data-area)─┘ ├─CFTABLE────┤ ├─CONNECTION─┤ └─RMI────────┘

| |

Conditions: END, ILLOGIC, NOTAUTH, UOWLNOTFOUND, UOWNOTFOUND

146

CICS User’s Handbook

SPI syntax

INQUIRE VTAM ┌── ───────────────────────────────────────────────┐ 55──INQUIRE VTAM───6┬─────────────────────────────────────────────┬┴──5% ├─GRNAME(data-area)───────────────────────────┤ ├─GRSTATUS(cvda)──────────────────────────────┤ ├─OPENSTATUS(cvda)────────────────────────────┤ └─┬─PSDINTERVAL(data-area)──────────────────┬─┘ └─┤ psinhrs ├──┤ psinmins ├──┤ psinsecs ├─┘ psinhrs: ├──PSDINTHRS(data-area)──┤ psinmins: ├──PSDINTMINS(data-area)──┤ psinsecs: ├──PSDINTSECS(data-area)──┤

Conditions: INVREQ, NOTAUTH

INQUIRE WEB ┌── ─────────────────────────┐ 55──INQUIRE WEB(data-area)───6┬───────────────────────┬┴──5% ├─GARBAGEINT(data-area)─┤ └─TIMEOUTINT(data-area)─┘

Conditions: NOTAUTH

PERFORM DELETSHIPPED 55──PERFORM DELETSHIPPED──5%

Conditions: NOTAUTH

Chapter 2. SPI command syntax

147

SPI syntax

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

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

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

Conditions: INVREQ

PERFORM RESETTIME 55──PERFORM RESETTIME──5%

Conditions: INVREQ, NOTAUTH

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

Conditions: INVREQ, IOERR, NORMAL, NOTAUTH, SYSBUSY

148

CICS User’s Handbook

SPI syntax

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

Conditions: INVREQ, NOTAUTH, TRANSIDERR

PERFORM STATISTICS RECORD

|

┌── ─────────────────────┐ 55──PERFORM STATISTICS RECORD───6┬───────────────────┬┴──5% ├─ALL──┬──────────┬─┤ │ └─RESETNOW─┘ │ ├─AUTOINSTALL───────┤ ├─CONNECTION────────┤ ├─DB2───────────────┤ ├─DISPATCHER────────┤ ├─ENQUEUE───────────┤ ├─FEPI──────────────┤ ├─FILE──────────────┤ ├─┬─JOURNALNAME─┬───┤ │ └─JOURNALNUM──┘ │ ├─LSRPOOL───────────┤ ├─MONITOR───────────┤ ├─PROGAUTO──────────┤ ├─PROGRAM───────────┤ ├─RECOVERY──────────┤ ├─STATS─────────────┤ ├─STORAGE───────────┤ ├─STREAMNAME────────┤ ├─SYSDUMP───────────┤ ├─TABLEMGR──────────┤ ├─TCPIPSERVICE──────┤ ├─TDQUEUE───────────┤ ├─TERMINAL──────────┤ ├─┬─TRANCLASS─┬─────┤ │ └─TCLASS────┘ │ ├─TRANDUMP──────────┤ ├─TRANSACTION───────┤ ├─TSQUEUE───────────┤ └─VTAM──────────────┘

Conditions: IOERR, NOTAUTH, NOTFND

Chapter 2. SPI command syntax

149

SPI syntax

RESYNC ENTRYNAME 55──RESYNC ENTRYNAME(data-value)──┬───────────────────────┬────────────────5 └─QUALIFIER(data-value)─┘ 5──┬──────────────────────────────────────────────────┬──┬─────────┬──5% └─IDLIST(data-value)──┬──────────────────────────┬─┘ └─PARTIAL─┘ └─IDLISTLENGTH(data-value)─┘

Conditions: NOTAUTH

SET AUTOINSTALL 55──SET AUTOINSTALL──┬────────────────┬──┬─────────────────────┬───────────5 └─CONSOLES(cvda)─┘ └─MAXREQS(data-value)─┘

|

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

Conditions: INVREQ, NOTAUTH, PGMIDERR

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

Conditions: INVREQ, IOERR, NORMAL, NOTAUTH, SYSIDERR

150

CICS User’s Handbook

SPI syntax

SET DB2CONN 55──SET DB2CONN────────────────────────────────────────────────────────────5 ┌── ───────────────────────────┐ ┌── ───────────────────────────┐ 5───6┬─────────────────────────┬┴───6┬─────────────────────────┬┴──5% ├─┬─ACCOUNTREC(cvda)─┬────┤ ├─DB2ID(data-area)────────┤ │ ├─UOW──────────────┤ │ ├─MSGQUEUE1(data-area)────┤ │ ├─TASK─────────────┤ │ ├─MSGQUEUE2(data-area)────┤ │ ├─TXID─────────────┤ │ ├─MSGQUEUE3(data-area)────┤ │ └─NONE─────────────┘ │ ├─┬─NONTERMREL(cvda)─┬────┤ ├─AUTHID(data-area)───────┤ │ ├─RELEASE──────────┤ │ ├─┬─AUTHTYPE(cvda)─┬──────┤ │ └─NORELEASE────────┘ │ │ ├─GROUP──────────┤ │ ├─PLAN(data-area)─────────┤ │ ├─SIGN───────────┤ │ ├─PLANEXITNAME(data-area)─┤ │ ├─TERM───────────┤ │ ├─┬─PRIORITY(cvda)─┬──────┤ │ ├─TX─────────────┤ │ │ ├─HIGH───────────┤ │ │ ├─OPID───────────┤ │ │ ├─EQUAL──────────┤ │ │ └─USERID─────────┘ │ │ └─LOW────────────┘ │ ├─┬─BUSY(cvda)─┬──────────┤ ├─PURGECYCLEM(data-area)──┤ │ ├─WAIT───────┤ │ ├─PURGECYCLES(data-area)──┤ │ ├─NOWAIT─────┤ │ ├─SECURITY(REBUILD)───────┤ │ └─FORCE──────┘ │ ├─SIGNID(data-area)───────┤ ├─COMAUTHID(data-area)────┤ ├─┬─STANDBYMODE(cvda)─┬───┤ ├─┬─COMAUTHTYPE(cvda)─┬───┤ │ ├─NOCONNECT─────────┤ │ │ ├─CGROUP────────────┤ │ │ ├─CONNECT───────────┤ │ │ ├─CSIGN─────────────┤ │ │ └─RECONNECT─────────┘ │ │ ├─CTERM─────────────┤ │ ├─STATSQUEUE(data-area)───┤ │ ├─CTX───────────────┤ │ ├─TCBLIMIT(data-area)─────┤ │ ├─COPID─────────────┤ │ ├─THREADLIMIT(data-area)──┤ │ └─CUSERID───────────┘ │ └─┬─THREADWAIT(cvda)─┬────┘ ├─COMTHREADLIM(data-area)─┤ ├─TWAIT────────────┤ ├─┬─CONNECTERROR(cvda)─┬──┤ ├─NOTWAIT──────────┤ │ ├─ABEND──────────────┤ │ └─N9ð6─────────────┘ │ └─SQLCODE────────────┘ │ └─┬─CONNECTST(cvda)─┬─────┘ ├─CONNECTED───────┤ └─NOTCONNECTED────┘

Conditions: NORMAL, NOTAUTH, NOTFND, INVREQ

Chapter 2. SPI command syntax

151

SPI syntax

55──SET DB2ENTRY──┬─────────────┬───────────────────────────────5 └─(data-area)─┘ ┌── ───────────────────────────┐ 5───6┬─────────────────────────┬┴───────────────────────────────5% ├─┬─ACCOUNTREC(cvda)─┬────┤ │ ├─UOW──────────────┤ │ │ ├─TASK─────────────┤ │ │ ├─TXID─────────────┤ │ │ └─NONE─────────────┘ │ ├─AUTHID(data-area)───────┤ ├─┬─AUTHTYPE(cvda)─┬──────┤ │ ├─GROUP──────────┤ │ │ ├─SIGN───────────┤ │ │ ├─TERM───────────┤ │ │ ├─TX─────────────┤ │ │ ├─OPID───────────┤ │ │ └─USERID─────────┘ │ ├─┬─BUSY(cvda)─┬──────────┤ │ ├─WAIT───────┤ │ │ ├─NOWAIT─────┤ │ │ └─FORCE──────┘ │ ├─┬─DISABLEDACT(cvda)─┬───┤ │ ├─ABEND─────────────┤ │ │ ├─SQLCODE───────────┤ │ │ └─POOL──────────────┘ │ ├─┬─ENABLESTATUS(cvda)─┬──┤ │ ├─ENABLED────────────┤ │ │ └─DISABLED───────────┘ │ ├─PLAN(data-area)─────────┤ ├─PLANEXITNAME(data-area)─┤ ├─┬─PRIORITY(cvda)─┬──────┤ │ ├─HIGH───────────┤ │ │ ├─EQUAL──────────┤ │ │ └─LOW────────────┘ │ ├─PROTECTNUM(data-area)───┤ ├─THREADLIMIT(data-area)──┤ └─┬─THREADWAIT(cvda)─┬────┘ ├─TWAIT────────────┤ ├─NOWAIT───────────┤ └─TPOOL────────────┘ Conditions: NOTAUTH, NOTFND, INVREQ

152

CICS User’s Handbook

SPI syntax

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

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

Conditions: INVREQ, NOTAUTH

SET DSNAME 55──SET DSNAME(data-value)──┬──────────────┬──┬────────────────────┬───────5 ├─ACTION(cvda)─┤ ├─AVAILABILITY(cvda)─┤ ├─REMOVE───────┤ ├─AVAILABLE──────────┤ ├─RECOVERED────┤ └─UNAVAILABLE────────┘ ├─RESETLOCKS───┤ └─RETRY────────┘ ┌─WAIT───────┐ 5──┬───────────────────┬──┼────────────┼──┬─────────────────┬──5% ├─QUESCESTATE(cvda)─┤ ├─BUSY(cvda)─┤ ├─UOWACTION(cvda)─┤ ├─QUIESCED──────────┤ └─NOWAIT─────┘ ├─BACKOUT─────────┤ ├─IMMQUIESCED───────┤ ├─COMMIT──────────┤ └─UNQUIESCED────────┘ └─FORCE───────────┘

Conditions: DSNNOTFOUND, INVREQ, IOERR, NOTAUTH, SUPPRESSED

Chapter 2. SPI command syntax

153

SPI syntax

SET DUMPDS 55──SET DUMPDS──┬────────────────────────┬──┬──────────────────┬───────────5 └─INITIALDDS(data-value)─┘ ├─OPENSTATUS(cvda)─┤ ├─CLOSED───────────┤ ├─OPEN─────────────┤ └─SWITCH───────────┘ 5──┬────────────────────┬──5% ├─SWITCHSTATUS(cvda)─┤ ├─NOSWITCH───────────┤ └─SWITCHNEXT─────────┘

Conditions: INVREQ, IOERR, NOTAUTH

||

SET ENQMODEL

| | |

|

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

Conditions: INVREQ, NOTAUTH, NOTFND

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

Conditions: FILENOTFOUND, INVREQ, IOERR, NOTAUTH

154

CICS User’s Handbook

SPI syntax

SET FILE FILE attributes: ┌─WAIT───────┐ ├──┬────────────┬──┬──────────────┬──┼────────────┼────────────────────────5 ├─ADD(cvda)──┤ ├─BROWSE(cvda)─┤ ├─BUSY(cvda)─┤ ├─ADDABLE────┤ ├─BROWSABLE────┤ ├─FORCE──────┤ └─NOTADDABLE─┘ └─NOTBROWSABLE─┘ └─NOWAIT─────┘ |

5──┬──────────────────────┬──┬──────────────┬──┬───────────────────┬───────5 └─CFDTPOOL(data-value)─┘ ├─DELETE(cvda)─┤ ├─DISPOSITION(cvda)─┤ ├─DELETABLE────┤ ├─OLD───────────────┤ └─NOTDELETABLE─┘ └─SHARE─────────────┘ 5──┬────────────────────────┬──┬───────────────────┬───────────────────────5 ├─DSNAME(data-value)─────┤ ├─EMPTYSTATUS(cvda)─┤ └─OBJECTNAME(data-value)─┘ ├─EMPTY─────────────┤ ├─EMPTYREQ──────────┤ └─NOEMPTYREQ────────┘ ┌── ──────────────────────────────┐ 5───6┬────────────────────────────┬┴──┬─────────────────┬───────────────────5 └─┬─┬─ENABLESTATUS(cvda)─┬─┬─┘ ├─EXCLUSIVE(cvda)─┤ │ ├─DISABLED───────────┤ │ ├─EXCTL───────────┤ │ └─ENABLED────────────┘ │ └─NOEXCTL─────────┘ └─┬─OPENSTATUS(cvda)─┬───┘ ├─CLOSED───────────┤ └─OPEN─────────────┘

| | |

5──┬───────────────────────┬──┬────────────────┬───────────────────────────5 └─KEYLENGTH(data-value)─┘ ├─LOADTYPE(cvda)─┤ ├─LOAD───────────┤ └─NOLOAD─────────┘ 5──┬───────────────────────┬──┬────────────────────────┬───────────────────5 └─LSRPOOLID(data-value)─┘ └─MAXNUMRECS(data-value)─┘

|

|

| | |

5──┬─────────────┬──┬────────────────────────┬──┬─────────────────┬────────5 ├─READ(cvda)──┤ └─RECORDSIZE(data-value)─┘ ├─READINTEG(cvda)─┤ ├─NOTREADABLE─┤ ├─UNCOMMITTED─────┤ └─READABLE────┘ ├─CONSISTENT──────┤ └─REPEATABLE──────┘ 5──┬─────────────────┬──┬─────────────────────┬──┬─────────────┬───────────5 ├─RLSACCESS(cvda)─┤ └─STRINGS(data-value)─┘ ├─TABLE(cvda)─┤ ├─RLS─────────────┤ ├─CFTABLE─────┤ ├─NOTAPPLIC───────┤ ├─CICSTABLE───┤ └─NOTRLS──────────┘ ├─NOTTABLE────┤ └─USERTABLE───┘ 5──┬───────────────────────┬──┬──────────────┬──┬───────────────────┬──┤ └─TABLENAME(data-value)─┘ ├─UPDATE(cvda)─┤ ├─UPDATEMODEL(cvda)─┤ ├─NOTUPDATABLE─┤ ├─CONTENTION────────┤ └─UPDATABLE────┘ └─LOCKING───────────┘

Chapter 2. SPI command syntax

155

SPI syntax

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

Conditions: INVREQ, IOERR, NOSTG, NOTAUTH

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

Conditions: INVREQ, IOERR, JIDERR, NOTAUTH

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

Conditions: INVREQ, NOTAUTH, SYSIDERR

156

CICS User’s Handbook

SPI syntax

SET MONITOR 55──SET MONITOR──┬──────────────────┬──┬──────────────────┬────────────────5 ├─CONVERSEST(cvda)─┤ ├─EVENTCLASS(cvda)─┤ ├─CONVERSE─────────┤ ├─EVENT────────────┤ └─NOCONVERSE───────┘ └─NOEVENT──────────┘

| |

5──┬───────────────────┬──┬──────────────────────────────────┬─────────────5 ├─EXCEPTCLASS(cvda)─┤ ├─FREQUENCY(data-value)────────────┤ ├─EXCEPT────────────┤ │ ┌── ──────────────────────────────┐ │ └─NOEXCEPT──────────┘ └──6─┬──────────────────────────┬─┴─┘ ├─FREQUENCYHRS(data-value)─┤ ├─FREQUENCYMIN(data-value)─┤ └─FREQUENCYSEC(data-value)─┘ 5──┬─────────────────┬──┬──────────────┬──┬───────────────────┬──5% ├─PERFCLASS(cvda)─┤ ├─STATUS(cvda)─┤ ├─SYNCPOINTST(cvda)─┤ ├─PERF────────────┤ ├─ON───────────┤ ├─SYNCPOINT─────────┤ └─NOPERF──────────┘ └─OFF──────────┘ └─NOSYNCPOINT───────┘

Conditions: INVREQ, NOTAUTH

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

Conditions: INVREQ, NOTAUTH

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

Conditions: INVREQ, NOTAUTH, PROCESSERR

Chapter 2. SPI command syntax

157

SPI syntax

SET PROGRAM 55──SET PROGRAM(data-value)──┬──────────────────┬──┬────────────┬──────────5 ├─CEDFSTATUS(cvda)─┤ ├─COPY(cvda)─┤ ├─CEDF─────────────┤ ├─NEWCOPY────┤ └─NOCEDF───────────┘ └─PHASEIN────┘ 5──┬────────────────────┬──┬───────────────────┬───────────────────────────5 ├─EXECUTIONSET(cvda)─┤ ├─SHARESTATUS(cvda)─┤ ├─DPLSUBSET──────────┤ ├─PRIVATE───────────┤ └─FULLAPI────────────┘ └─SHARED────────────┘ | | |

5──┬───────────────────────────────────┬──┬────────────────┬───────────────5 └─JVMCLASS(255-character data-area)─┘ ├─JVMDEBUG(cvda)─┤ ├─DEBUG──────────┤ └─NODEBUG────────┘

| | |

5──┬───────────────┬──┬──────────────┬──┬───────────────┬──5% ├─RUNTIME(cvda)─┤ ├─STATUS(cvda)─┤ └─VERSION(cvda)─┘ ├─JVM───────────┤ ├─DISABLED─────┤ └─NOJVM─────────┘ └─ENABLED──────┘

Conditions: INVREQ, IOERROR, NOTAUTH, PGMIDERR

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

Conditions: INVREQ, NOTAUTH

158

CICS User’s Handbook

SPI syntax

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

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

SET SYSTEM

|

| | |

┌── ────────────────────────────────────────────────────┐ 55──SET SYSTEM───6┬──────────────────────────────────────────────────┬┴──5% ├─AKP(data-value)──────────────────────────────────┤ ├─DSALIMIT(data-value)─────────────────────────────┤ ├─DSRTPROGRAM(data-value)──────────────────────────┤ ├─DTRPROGRAM(data-value)───────────────────────────┤ ├─┬─DUMPING(cvda)─┬────────────────────────────────┤ │ ├─NOSYSDUMP─────┤ │ │ └─SYSDUMP───────┘ │ ├─EDSALIMIT(data-value)────────────────────────────┤ ├─FORCEQR(cvda)────────────────────────────────────┤ ├─GMMTEXT(data-value)──┬───────────────────────┬───┤ │ └─GMMLENGTH(data-value)─┘ │ ├─LOGDEFER(data-area)──────────────────────────────┤ ├─MAXOPENTCBS(data-value)──────────────────────────┤ ├─MAXTASKS(data-value)──┬────────────────────────┬─┤ │ └─NEWMAXTASKS(data-area)─┘ │ ├─MROBATCH(data-value)─────────────────────────────┤ ├─┬─PROGAUTOCTLG(cvda)─┬───────────────────────────┤ │ ├─CTLGALL────────────┤ │ │ ├─CTLGMODIFY─────────┤ │ │ └─CTLGNONE───────────┘ │ ├─PROGAUTOEXIT(data-value)─────────────────────────┤ ├─┬─PROGAUTOINST(cvda)─┬───────────────────────────┤ │ ├─AUTOACTIVE─────────┤ │ │ └─AUTOINACTIVE───────┘ │ ├─PRTYAGING(data-value)────────────────────────────┤ ├─RUNAWAY(data-value)──────────────────────────────┤ ├─SCANDELAY(data-value)────────────────────────────┤ └─TIME(data-value)─────────────────────────────────┘

Conditions: INVREQ, LENGERR, NOSTG, NOTAUTH

Chapter 2. SPI command syntax

159

SPI syntax

SET TASK 55──SET TASK(data-value)──┬──────────────────────┬──┬─────────────────┬──5% └─PRIORITY(data-value)─┘ ├─PURGETYPE(cvda)─┤ ├─FORCEPURGE──────┤ └─PURGE───────────┘

Conditions: INVREQ, NOTAUTH, TASKIDERR

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

Conditions: INVREQ, NOTAUTH, TCIDERR

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

Conditions: INVREQ, IOERR, NOTAUTH

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

Conditions: INVREQ, NOTAUTH, NOTFND

160

CICS User’s Handbook

SPI syntax

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

Conditions: INVREQ, IOERR, NOTAUTH, QIDERR, USERIDERR

Chapter 2. SPI command syntax

161

SPI syntax

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

Conditions: INVREQ, NORMAL, NOTAUTH, TERMIDERR

162

CICS User’s Handbook

SPI syntax

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

Conditions: INVREQ, IOERR, NOSPACE, NOSTG, NOTAUTH

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

Conditions: INVREQ, NOTAUTH

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

Conditions: NOTAUTH, NOTFND

Chapter 2. SPI command syntax

163

SPI syntax

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

Conditions: INVREQ, NOTAUTH, TCIDERR

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

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

164

CICS User’s Handbook

SPI syntax

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

Conditions: INVREQ, NOTAUTH, TRANSIDERR

||

SET TSQUEUE

| | |

55──SET ──┬─TSQUEUE(data-value)─┬──┬──────────────────────┬────────────────5 └─TSQNAME(data-value)─┘ ├─SYSID(data-value)────┤ └─POOLNAME(data-value)─┘

| | | |

5──┬───────────────────────────────────────────┬──5% ├─ACTION(cvda)─┬─────────────────────────┬──┤ │ └─LASTUSEDINT(data-value)─┘ │ └─DELETE────────────────────────────────────┘

| |

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

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

Conditions: INVREQ, NOTAUTH, UOWNOTFOUND

Chapter 2. SPI command syntax

165

SPI syntax

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

Conditions: INVREQ, NOTAUTH, UOWLNOTFOUND

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

Conditions: INVREQ, IOERR, NOTAUTH

SET WEB 55──SET WEB──┬────────────────────────┬──┬────────────────────────┬──5% └─GARBAGEINT(data-value)─┘ └─TIMEOUTINT(data-value)─┘

Conditions: INVREQ, IOERR, NOTAUTH

166

CICS User’s Handbook

CST syntax

Chapter 3. CICS-Supplied Transaction Some CICS-supplied transactions are menu driven, while others can 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 55──CEBT Inquire Auxtrace──5%

CEBT INQUIRE DUMP 55──CEBT Inquire Dump──5%

CEBT INQUIRE INTTRACE 55──CEBT Inquire Inttrace──5%

CEBT INQUIRE GTFTRACE 55──CEBT Inquire Gtftrace──5%

CEBT INQUIRE SURVEILLANCE 55──CEBT Inquire Surveillance──5%

CEBT PERFORM SHUTDOWN 55──CEBT Perform SHutdown──Dump──Immediate──5%

CEBT PERFORM SNAP 55──CEBT Perform SNap──5%

CEBT PERFORM TAKEOVER 55──CEBT Perform Takeover──Dump──5%

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

 Copyright IBM Corp. 1989, 1999

167

CST syntax

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

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

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

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

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

168

CICS User’s Handbook

CST syntax

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

CEDX ┌─,ON──┐ 55──CEDX──tranid──┼──────┼──5% └─,OFF─┘

170

CICS User’s Handbook

CST syntax

CEMT DISCARD

| |

| | |

|

┌── ───────────────────────┐ 55──CEMT Discard───6┬─────────────────────┬┴──5% ├─Autinstmodel(value)─┤ ├─Connection(value)───┤ ├─DB2Conn─────────────┤ ├─DB2Entry(value)─────┤ ├─DB2TRAN(value)──────┤ ├─Doctemplate(value)──┤ ├─Enqmodel(value)─────┤ ├─FENode(value)───────┤ ├─FEPool(value)───────┤ ├─FEPropset(value)────┤ ├─FETarget(value)─────┤ ├─FIle(value)─────────┤ ├─JModel(value)───────┤ ├─JOurnalname(value)──┤ ├─PArtner(value)──────┤ ├─PROCesstype(value)──┤ ├─PROFile(value)──────┤ ├─PROGram(value)──────┤ ├─Requestmodel(value)─┤ ├─TClass(value)───────┤ ├─TCPIPservice(value)─┤ ├─TDqueue(value)──────┤ ├─TErminal(value)─────┤ ├─TRansaction(value)──┤ └─TSmodel(name)───────┘

CEMT INQUIRE AUTOINSMODEL 55──CEMT Inquire AUTInstmodel───┬─────┬───5% └─All─┘

CEMT INQUIRE AUTOINSTALL 55──CEMT Inquire AUTOinstall──5%

CEMT INQUIRE AUXTRACE 55──CEMT Inquire AUXtrace──5%

Chapter 3. CICS-Supplied Transaction

171

CST syntax

CEMT INQUIRE CONNECTION 55──CEMT Inquire Connection──┬─(value)─┬──┬────────────────┬──┬────────────┬───5 └─ALl─────┘ └─NEtname(value)─┘ ├─NOTPending─┤ └─PEnding────┘ | | | |

5──┬────────────┬──┬───────────┬──┬──────────────┬──┬─────────────┬────────────5 ├─INService──┤ ├─ACquired──┤ ├─NOTSupported─┤ ├─Vtam────────┤ └─OUtservice─┘ ├─RELeased──┤ ├─Unattempted──┤ ├─IRc─────────┤ ├─OBtaining─┤ ├─COMPlete─────┤ ├─XM──────────┤ ├─FReeing───┤ └─Failed───────┘ ├─INDirect────┤ └─AVailable─┘ ├─XCf─────────┤ └─RConnection─┘ 5──┬──────┬──┬──────────┬──┬─────────────┬──┬───────────────┬──────────────────5 ├─EXci─┤ ├─XOk──────┤ ├─RECovdata───┤ └─Grname(value)─┘ ├─APpc─┤ └─XNotdone─┘ ├─NORecovdata─┤ └─Lu61─┘ └─NRs─────────┘ 5──┬───────────────────┬──┬─────────────────────┬──┬──────────────┬────────────5 └─Membername(value)─┘ └─REMotesystem(value)─┘ └─RNAme(value)─┘ 5──┬─────────────────┬──5% └─RNEtname(value)─┘

CEMT INQUIRE DB2CONN 55──CEMT Inquire DB2Conn──5%

172

CICS User’s Handbook

CST syntax

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

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

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

Chapter 3. CICS-Supplied Transaction

173

CST syntax

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

CEMT INQUIRE DSAS 55──CEMT Inquire DSAs──5%

CEMT INQUIRE DSNAME ┌─ALl────────────────┐ 55──CEMT Inquire DSName──┼────────────────────┼──5% ├─(value)────────────┤ ├─┬─VSam─┬───────────┤ │ └─BDam─┘ │ ├─FIlecount(value)───┤ ├─┬─VAlid───┬────────┤ │ └─INvalid─┘ │ ├─┬─Path─┬───────────┤ │ └─BASE─┘ │ ├─┬─FWDRECOVAble─┬───┤ │ ├─NOTrecovable─┤ │ │ ├─RECOVERAble──┤ │ │ └─UNDetermined─┘ │ ├─┬─Static───────┬───┤ │ ├─Dynamic──────┤ │ │ └─UNDetermined─┘ │ ├─FRlog(value)───────┤ ├─┬─AVailable───┬────┤ │ └─UNAvailable─┘ │ ├─┬─NOLostlocks──┬───┤ │ ├─REMLostlocks─┤ │ │ └─RECOVERLocks─┘ │ ├─┬─RETAined───┬─────┤ │ └─NORetained─┘ │ ├─┬─Quiesced───┬─────┤ │ └─UNQuiesced─┘ │ ├─BASEDsname(value)──┤ └─FWDRECOVLsn(value)─┘

CEMT INQUIRE DUMPDS 55──CEMT Inquire DUmpds──5%

174

CICS User’s Handbook

CST syntax ||

CEMT INQUIRE ENQ

| |

55──CEMT Inquire Enq──┬────────────┬──┬────────────────┬──┬───────────────┬────5 └─Uow(value)─┘ └─TRansid(value)─┘ └─TAskid(value)─┘

| | | | | | |

5──┬──────────┬──┬─────────────┬──┬────────┬──┬─────────────────┬──────────────5 ├─ACtive───┤ ├─Dataset─────┤ ├─Owner──┤ └─Netuowid(value)─┘ └─RETained─┘ ├─File────────┤ └─Waiter─┘ ├─EXecenq─────┤ ├─ADdrexecenq─┤ ├─TDq─────────┤ └─TSq─────────┘

| |

5──┬─────────────────┬──┬─────────────────┬──┬─────────────┬───────────────────5 └─ENqfails(value)─┘ └─RESource(value)─┘ └─RLen(value)─┘

| |

5──┬──────────────────┬──┬─────────────┬──5% └─QUalifier(value)─┘ └─QLen(value)─┘

||

CEMT INQUIRE ENQMODEL

| | | |

55──CEMT Inquire ENQModel──┬─(value)─────────┬──┬──────────┬──5% ├─ENQSCOPE(value)─┤ ├─DISABLED─┤ └─ENQNAME(value)──┘ ├─ENABLED──┤ └─WAITING──┘

|

55──CEMT Inquire Exci──┬──────────────┬──5% ├─Task(number)─┤ └─Urid(value)──┘

CEMT INQUIRE EXCI

CEMT INQUIRE FILE ┌─ALl─────┐ 55──CEMT Inquire FIle──┼─────────┼──┬────────┬──┬────────┬──┬───────────┬──────5 └─(value)─┘ ├─Vsam───┤ ├─OPen───┤ ├─ENabled───┤ ├─BDam───┤ └─CLosed─┘ ├─UNenabled─┤ └─REMote─┘ └─DIsabled──┘ 5──┬────────┬──┬──────────┬──┬───────────┬──┬──────────┬──┬──────────┬─────────5 ├─REAd───┤ ├─UPdate───┤ ├─ADdable───┤ ├─BRowse───┤ ├─DElete───┤ └─NORead─┘ └─NOUpdate─┘ └─NOAddable─┘ └─NOBrowse─┘ └─NODelete─┘ 5──┬─────────────┬──┬───────┬──┬────────┬──┬────────────┬──────────────────────5 ├─EXclusive───┤ ├─OLd───┤ ├─RLs────┤ ├─EMptyreq───┤ └─NOEXclusive─┘ └─Share─┘ └─NOTRls─┘ └─NOEMptyreq─┘ | | | |

5──┬───────────────┬──┬───────────┬──┬────────┬──┬─────────────────┬───────────5 └─DSname(value)─┘ ├─NOTTable──┤ ├─LOAd───┤ └─CFDtpool(value)─┘ ├─CIcstable─┤ └─NOLoad─┘ ├─USertable─┤ └─CFTable───┘

| |

5──┬──────────────────┬──┬────────────┬──┬───────────────────┬─────────────────5 └─Tablename(value)─┘ ├─LOCKING────┤ └─Maxnumrecs(value)─┘ └─COntention─┘

|

5──┬──────────────────┬──┬───────────────────┬──5% └─Keylength(value)─┘ └─RECordsize(value)─┘

CEMT INQUIRE GTFTRACE 55──CEMT Inquire Gtftrace──5%

Chapter 3. CICS-Supplied Transaction

175

CST syntax

CEMT INQUIRE INTTRACE 55──CEMT Inquire INttrace──5%

CEMT INQUIRE IRC 55──CEMT Inquire IRc──5%

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

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

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

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

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

176

CICS User’s Handbook

CST syntax

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

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

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

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

Chapter 3. CICS-Supplied Transaction

177

CST syntax

CEMT INQUIRE PROGRAM ┌─ALl──────────┐ 55──CEMT Inquire PROGram──┼──────────────┼──┬───────────────┬──────────────────5 ├─(value)──────┤ └─LENgth(value)─┘ └─CLass(value)─┘

|

┌─PRIvate─┐ 5──┬────────────┬──┬──────────────┬──┬──────────┬──┼─────────┼─────────────────5 ├─PLi────────┤ ├─PROgram──────┤ ├─Enabled──┤ └─Shared──┘ ├─CObol──────┤ ├─Mapset───────┤ └─DIsabled─┘ ├─C──────────┤ └─PArtitionset─┘ ├─LE37ð──────┤ ├─ASsembler──┤ ├─NOTDEfined─┤ └─JAVA───────┘

| |

5──┬─────────────┬──┬────────┬──┬────────────┬──┬─────────────────┬────────────5 ├─REQuired────┤ ├─CEDf───┤ ├─DYnamic────┤ └─REScount(value)─┘ └─NOTRequired─┘ └─NOCedf─┘ └─NOTDYnamic─┘ 5──┬─────────────────┬──┬───────┬──┬──────────┬──┬───────────┬─────────────────5 └─USecount(value)─┘ ├─ANy───┤ ├─CEXeckey─┤ ├─DPlsubset─┤ └─Below─┘ └─UExeckey─┘ └─Fullapi───┘

| | | |

5──┬────────────┬──┬─────────────────────┬──┬──────────┬──┬─────────┬──────────5 ├─Quasirent──┤ └─REMotesystem(value)─┘ ├─JVM──────┤ ├─DEBug───┤ └─Threadsafe─┘ ├─LE37ð────┤ └─NODebug─┘ ├─NONLE37ð─┤ └─UNKNOWN──┘

|

5──┬─────────────────┬──5% └─JVMClass(value)─┘

CEMT INQUIRE STATISTICS 55──CEMT Inquire STAtistics──5%

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

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

CEMT INQUIRE SYSTEM 55──CEMT Inquire SYStem──5%

178

CICS User’s Handbook

CST syntax

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

|

5──┬────────┬──┬────────────────┬──┬───────────────────┬───────────────────────5 ├─Nowait─┤ └─DB2plan(value)─┘ └─ACTIVITYId(value)─┘ └─Wait───┘ 5──┬─────────────────┬──┬────────────────┬──┬────────────────────┬──5% └─ACTIVITY(value)─┘ └─PROCESS(value)─┘ └─PROCESSType(value)─┘

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

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

Chapter 3. CICS-Supplied Transaction

179

CST syntax

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

CEMT INQUIRE TERMINAL ┌─ALl──────────┐ 55──CEMT Inquire TErminal──┼──────────────┼──┬────────────────────┬────────────5 ├─(value)──────┤ └─TRansaction(value)─┘ └─CLass(value)─┘ |

5──┬────────────────┬──┬─────────────────┬──┬──────────────┬───────────────────5 └─COnsole(value)─┘ └─PRiority(value)─┘ ├─PAgeable─────┤ └─AUtopageable─┘ 5──┬────────────┬──┬───────┬──┬───────┬──┬───────────┬──┬────────────────┬─────5 ├─Inservice──┤ ├─ATi───┤ ├─TTi───┤ ├─RTerminal─┤ └─NEtname(value)─┘ └─Outservice─┘ └─NOAti─┘ └─NOTti─┘ ├─RSession──┤ ├─Session───┤ └─Local─────┘ 5──┬──────────┬──┬──────────┬──┬─────────────┬──┬─────────────────────┬────────5 ├─ACquired─┤ ├─CReate───┤ └─TAsk(value)─┘ └─REMotesystem(value)─┘ └─RELeased─┘ └─NOCreate─┘ 5──┬──────────────┬──┬─────────────────┬──┬───────────────┬──┬────────────┬──5% └─RNAme(value)─┘ └─RNEtname(value)─┘ └─Userid(value)─┘ └─CId(value)─┘

180

CICS User’s Handbook

CST syntax

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

5──┬─────────────┬──5% ├─Routable────┤ └─NOTRoutable─┘

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

|| | | | | | | | | |

|| | | |

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

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

Chapter 3. CICS-Supplied Transaction

181

CST syntax

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

CEMT INQUIRE TSQUEUE | | |

┌─ALl─────┐ 55──CEMT Inquire TSQueue──┼─────────┼──┬─────────────────┬─────────────────────5 └─(value)─┘ ├─SYSID(value)────┤ └─POOLNAME(value)─┘ 5──┬─────────────────┬──┬────────────────────┬──┬───────────────┬──────────────5 └─Numitems(value)─┘ └─LAstusedint(value)─┘ └─LEngth(value)─┘ 5──┬───────────┬──┬───────────────────┬──┬───────────────────┬─────────────────5 ├─MAIn──────┤ └─MAXitemlen(value)─┘ └─MInitemlen(value)─┘ └─AUxiliary─┘

|

5──RECOVSTATUS(value)──┬────────────────┬──5% └─Transid(value)─┘

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

182

CICS User’s Handbook

CST syntax

CEMT INQUIRE UOWDSNFAIL 55──CEMT Inquire UOWDsnfail──UOw(value)──DSname(value)──┬────────┬─────────────5 ├─NOtrls─┤ └─RLS────┘ 5──┬────────────┬──┬──────────────┬──┬──────────────┬──┬────────────────┬──5% ├─CAche──────┤ ├─Backupnonbwo─┤ └─Sysid(value)─┘ └─NEtname(value)─┘ ├─CONnection─┤ ├─COMmitfail───┤ ├─DATASET────┤ ├─DATASETFull──┤ ├─RLSServer──┤ ├─DEAdlock─────┤ └─UNdefined──┘ ├─DELexiterror─┤ ├─Failedbkout──┤ ├─INDExrecfull─┤ ├─IOerror──────┤ ├─Openerror────┤ ├─RLSGone──────┤ ├─INDOubt──────┤ ├─RRCommitfail─┤ ├─RRIndoubt────┤ └─Lckstrucfull─┘

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

CEMT INQUIRE UOWLINK ┌─ALl─────┐ 55──CEMT Inquire UOWLink──┼─────────┼──┬────────────┬──┬────────────┬──────────5 └─(value)─┘ └─UOw(value)─┘ ├─CONnection─┤ └─RMI────────┘

|

5──┬─────────────┬──┬─────────────┬──┬───────────┬──┬─────────────┬────────────5 └─LInk(value)─┘ ├─COOrdinator─┤ ├─Irc───────┤ ├─COLdstart───┤ ├─SUbordinate─┤ ├─APpc──────┤ ├─STarting────┤ └─UNKnown─────┘ ├─LU61──────┤ ├─Warmstart───┤ ├─NOtapplic─┤ ├─UNAvailable─┤ └─Rrms──────┘ ├─UNConnected─┤ └─NOtapplic───┘ 5──┬──────────────┬──┬───────────────┬──┬─────────────────┬──5% └─SYsid(value)─┘ └─RMIQfy(value)─┘ └─NEtuowid(value)─┘

CEMT INQUIRE VTAM 55──CEMT Inquire Vtam──5%

Chapter 3. CICS-Supplied Transaction

183

CST syntax

CEMT PERFORM DELETSHIPPED 55──CEMT Perform DEletshipped──5%

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

CEMT PERFORM RESET 55──CEMT Perform Reset──5%

CEMT PERFORM SECURITY REBUILD 55──CEMT Perform SEcurity───┬─────────┬───5% └─Rebuild─┘

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

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

184

CICS User’s Handbook

CST syntax

CEMT PERFORM STATISTICS

|

┌── ─────────────────────┐ 55──CEMT Perform STatistics───┬────────┬────6┬─ALl──┬──────────┬─┬┴──5% └─RECORd─┘ │ └─RESetnow─┘ │ ├─AUtoinstall───────┤ ├─Connection────────┤ ├─DB2───────────────┤ ├─DIspatcher────────┤ ├─Enqueue───────────┤ ├─FEpi──────────────┤ ├─FIle──────────────┤ ├─Journalname───────┤ ├─Lsrpool───────────┤ ├─Monitor───────────┤ ├─PROGAuto──────────┤ ├─PROGRam───────────┤ ├─RECOVery──────────┤ ├─STAts─────────────┤ ├─STOrage───────────┤ ├─STReamname────────┤ ├─SYsdump───────────┤ ├─TAblemgr──────────┤ ├─TCLass────────────┤ ├─TCPipservice──────┤ ├─TDqueue───────────┤ ├─TErminal──────────┤ ├─TRAnsaction───────┤ ├─TRDump────────────┤ ├─TSqueue───────────┤ └─Vtam──────────────┘

CEMT SET AUTOINSTALL |

55──CEMT Set AUToinstall──┬─────────────────┬──┬────────────────┬──────────────5 └─Consoles(value)─┘ └─Maxreqs(value)─┘ 5──┬────────────────┬──5% └─Program(value)─┘

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

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

Chapter 3. CICS-Supplied Transaction

185

CST syntax

CEMT SET DB2CONN 55──CEMT Set DB2Conn───────────────────────────────────────────────────────────5 ┌── ───────────────────────────┐ ┌── ───────────────────────────┐ 5───6┬─────────────────────────┬┴───6┬─────────────────────────┬┴──5% ├─┬─ACCOUNTREC(cvda)─┬────┤ ├─DB2ID(data-area)────────┤ │ ├─UOW──────────────┤ │ ├─MSGQUEUE1(data-area)────┤ │ ├─TASK─────────────┤ │ ├─MSGQUEUE2(data-area)────┤ │ ├─TXID─────────────┤ │ ├─MSGQUEUE3(data-area)────┤ │ └─NONE─────────────┘ │ ├─┬─NONTERMREL(cvda)─┬────┤ ├─AUTHID(data-area)───────┤ │ ├─RELEASE──────────┤ │ ├─┬─AUTHTYPE(cvda)─┬──────┤ │ └─NORELEASE────────┘ │ │ ├─GROUP──────────┤ │ ├─PLAN(data-area)─────────┤ │ ├─SIGN───────────┤ │ ├─PLANEXITNAME(data-area)─┤ │ ├─TERM───────────┤ │ ├─┬─PRIORITY(cvda)─┬──────┤ │ ├─TX─────────────┤ │ │ ├─HIGH───────────┤ │ │ ├─OPID───────────┤ │ │ ├─EQUAL──────────┤ │ │ └─USERID─────────┘ │ │ └─LOW────────────┘ │ ├─COMAUTHID(data-area)────┤ ├─PURGECYCLEM(data-area)──┤ ├─┬─COMAUTHTYPE(cvda)─┬───┤ ├─PURGECYCLES(data-area)──┤ │ ├─CGROUP────────────┤ │ ├─SECURITY(REBUILD)───────┤ │ ├─CSIGN─────────────┤ │ ├─SIGNID(data-area)───────┤ │ ├─CTERM─────────────┤ │ ├─┬─STANDBYMODE(cvda)─┬───┤ │ ├─CTX───────────────┤ │ │ ├─NOCONNECT─────────┤ │ │ ├─COPID─────────────┤ │ │ ├─CONNECT───────────┤ │ │ └─CUSERID───────────┘ │ │ └─RECONNECT─────────┘ │ ├─COMTHREADLIM(data-area)─┤ ├─STATSQUEUE(data-area)───┤ ├─┬─CONNECTERROR(cvda)─┬──┤ ├─TCBLIMIT(data-area)─────┤ │ ├─ABEND──────────────┤ │ ├─THREADLIMIT(data-area)──┤ │ └─SQLCODE────────────┘ │ └─┬─THREADWAIT(cvda)─┬────┘ └─┬─CONNECTST(cvda)───┬───┘ ├─TWAIT────────────┤ ├─CONNECTED─────────┤ ├─NOTWAIT──────────┤ ├─NOTCONNECTED──────┤ └─N9ð6─────────────┘ └─FORCENOTCONNECTED─┘

186

CICS User’s Handbook

CST syntax

CEMT SET DB2ENTRY ┌── ───────────────────────────┐ 55──CEMT Set DB2Entry──┬─────────────┬───6┬─────────────────────────┬┴──5% └─(data-area)─┘ ├─┬─ACCOUNTREC(cvda)─┬────┤ │ ├─UOW──────────────┤ │ │ ├─TASK─────────────┤ │ │ ├─TXID─────────────┤ │ │ └─NONE─────────────┘ │ ├─AUTHID(data-area)───────┤ ├─┬─AUTHTYPE(cvda)─┬──────┤ │ ├─GROUP──────────┤ │ │ ├─SIGN───────────┤ │ │ ├─TERM───────────┤ │ │ ├─TX─────────────┤ │ │ ├─OPID───────────┤ │ │ └─USERID─────────┘ │ ├─┬─DISABLEDACT(cvda)─┬───┤ │ ├─ABEND─────────────┤ │ │ ├─SQLCODE───────────┤ │ │ └─POOL──────────────┘ │ ├─┬─ENABLESTATUS(cvda)─┬──┤ │ ├─ENABLED────────────┤ │ │ ├─DISABLED───────────┤ │ │ └─FORCEDISABLED──────┘ │ ├─PLAN(data-area)─────────┤ ├─PLANEXITNAME(data-area)─┤ ├─┬─PRIORITY(cvda)─┬──────┤ │ ├─HIGH───────────┤ │ │ ├─EQUAL──────────┤ │ │ └─LOW────────────┘ │ ├─PROTECTNUM(data-area)───┤ ├─THREADLIMIT(data-area)──┤ └─┬─THREADWAIT(cvda)─┬────┘ ├─TWAIT────────────┤ ├─NOTWAIT──────────┤ └─TPOOL────────────┘

CEMT SET DB2TRAN ┌── ───────────────────────┐ 55──CEMT Set DB2Tran───6┬─────────────────────┬┴──5% ├─DB2Entry(data-area)─┤ └─Transid(data-area)──┘

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

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

Chapter 3. CICS-Supplied Transaction

187

CST syntax

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

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

|| | | |

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

CEMT SET FILE 55──CEMT Set FIle──┬─(value)─┬──┬────────────┬──┬──────────┬──┬────────┬───────5 └─ALl─────┘ ├─OPen───────┤ ├─ENabled──┤ ├─REAd───┤ ├─CLosed─────┤ └─DIsabled─┘ └─NORead─┘ └─Forceclose─┘ 5──┬──────────┬──┬───────────┬──┬──────────┬──┬──────────┬──┬─────────────┬────5 ├─UPdate───┤ ├─ADdable───┤ ├─BRowse───┤ ├─DElete───┤ ├─EXclusive───┤ └─NOUpdate─┘ └─NOAddable─┘ └─NOBrowse─┘ └─NODelete─┘ └─NOEXclusive─┘

|

5──┬────────────┬──┬───────┬──┬────────┬──┬───────────────┬──┬───────────┬─────5 ├─EMptyreq───┤ ├─Old───┤ ├─RLs────┤ └─DSname(value)─┘ ├─NOTTable──┤ └─NOEMptyreq─┘ └─Share─┘ └─NOTRls─┘ ├─CIcstable─┤ ├─USertable─┤ └─CFTable───┘

| |

5──┬────────┬──┬─────────────────┬──┬──────────────────┬──┬────────────┬───────5 ├─LOAd───┤ └─CFDtpool(value)─┘ └─Tablename(value)─┘ ├─COntention─┤ └─NOLoad─┘ └─LOCking────┘

|

5──┬───────────────────┬──┬──────────────────┬──┬───────────────────┬──5% └─Maxnumrecs(value)─┘ └─Keylength(value)─┘ └─RECordsize(value)─┘

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

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

188

CICS User’s Handbook

CST syntax

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

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

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

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

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

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

Chapter 3. CICS-Supplied Transaction

189

CST syntax

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

CEMT SET PROGRAM ┌─PRIvate─┐ 55──CEMT Set Program──┬─(value)──────┬──┬──────────┬──┼─────────┼──────────────5 ├─CLass(value)─┤ ├─Enabled──┤ └─Shared──┘ └─ALl──────────┘ └─DIsabled─┘ | |

5──┬─────────┬──┬────────┬──┬───────────┬──┬─────────────────┬──┬─────────┬────5 ├─NEwcopy─┤ ├─CEDf───┤ ├─DPlsubset─┤ └─JVMClass(value)─┘ ├─DEBUG───┤ └─PHasein─┘ └─NOCedf─┘ └─Fullapi───┘ └─NODEBUG─┘

| |

5──┬───────┬──5% ├─JVM───┤ └─NOJVM─┘

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

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

190

CICS User’s Handbook

CST syntax

CEMT SET SYSTEM

| | | | |

┌── ────────────────────────┐ 55──CEMT Set SYStem───6┬──────────────────────┬┴──5% ├─AGing(value)─────────┤ ├─AKp(value)───────────┤ ├─DSAlimit(value)──────┤ ├─DSRtprogram(value)───┤ ├─DTrprogram(value)────┤ ├─EDsalimit(value)─────┤ ├─Forceqr─┬─Force───┬──┤ │ └─NOForce─┘ │ ├─Logdefer(value)──────┤ ├─MAXOpentcbs(value)───┤ ├─MAxtasks(value)──────┤ ├─MRobatch(value)──────┤ ├─┬─CTLGAll────┬───────┤ │ ├─CTLGModify─┤ │ │ └─CTLGNone───┘ │ ├─Progautoexit(value)──┤ ├─┬─AUTOActive───┬─────┤ │ └─AUTOInactive─┘ │ ├─RUnaway(value)───────┤ ├─SCandelay(value)─────┤ ├─Time(value)──────────┤ └─┬─SYsdump───┬────────┘ └─NOSysdump─┘

CEMT SET TASK 55──CEMT Set TAsk──┬─(value)─┬──┬─────────────────┬──┬────────────┬──5% └─All─────┘ └─PRiority(value)─┘ ├─PUrge──────┤ └─FOrcepurge─┘

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

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

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

Chapter 3. CICS-Supplied Transaction

191

CST syntax

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

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

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

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

||

CEMT SET TSQUEUE

| | | |

┌─ALl─────┐ 55──CEMT Set TSqueue──┼─────────┼──┬─────────────────┬─────────────────────────5 └─(value)─┘ ├─SYSID(value)────┤ └─POOLNAME(value)─┘

| |

5──┬────────────────────┬──┬─Action(value)─┬──5% └─LAstusedint(value)─┘ └─DELETE────────┘

192

CICS User’s Handbook

CST syntax

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

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

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

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

CESF 55──CESF──┬───────────┬──5% ├─GOODNIGHT─┤ └─LOGOFF────┘

CESN |

55──CESN

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

5──┬───────────────┬──┬──────────────┬──┬─────────────────┬──5% └─,LANGUAGE=lll─┘ └─,PS=pppppppp─┘ └─,NEWPS=password─┘

Note: 1 Do not use blanks between parameters in the comma-separated list.

Chapter 3. CICS-Supplied Transaction

193

CST syntax

CMSG 55──CMSG──┬──────┬──'message'──────────────────────────────────────────────────5 └─MSG=─┘ ┌── ──────────────┐ 5──┬─────────────────────────────────────────────────┬───6┬────────────┬┴───────5 │ ┌── ───────────────┐ │ └─,OPCLASS=n─┘ └─,ROUTE=──┬──6─Termid──/opid─┴──────────────────┬─┘ ├─ALL────────────────────────────────┤ │ ┌── ───────────┐ ┌── ─────────────────┐ │ └──6─.termlist─┴───6─,±termid──/opid─┴─┘ 5──┬─────────────┬──┬─────────────────┬──┬───────────────────────┬─────────────5 └─,TIME=value─┘ ├─,DATE=value─────┤ └─,ERRTERM=─┬─Termid─┬──┘ └─,FULLDATE=value─┘ └─ORIG───┘ 5──┬─────────────┬──┬────────────────────┬──┬───────────────────────┬──────────5 └─,ID=(title)─┘ └─,HEADING=─┬─YES─┬──┘ └─,PROTECT=─┬─YES────┬──┘ └─NO──┘ ├─NO─────┤ └─Prefix─┘ 5──┬─,SEND───┬──5% └─,CANCEL─┘

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

CRTE 55──CRTE──SYSID=sysid──┬────────────────┬──5% └─,TRPROF=trprof─┘

CSFE SPOOLFE 55──CSFE spoolfe=──┬─ON──┬──5% └─OFF─┘

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

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

194

CICS User’s Handbook

CST syntax

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

CSPG GETPAGE 55──CSPG──Getpage──┬───┬──B──┬──────┬──┬─────────┬──5% └─A─┘ ├─\ldc─┤ └─,hhhhhh─┘ └─\ALL─┘

CSPG MESSCHNYYYY 55──CSPG──Messchnyyyy──┬────────────┬──5% └─Parameters─┘

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

CWTO 55──CWTO──Message──5%

Chapter 3. CICS-Supplied Transaction

195

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 55──ADd──Group(groupname1)──LIst(listname)──┬────────────────────┬──5% ├─Before(groupname2)─┤ └─After(groupname3)──┘

ALTER syntax

| |

| | |

|

55──ALter──┬─Connection(name)───┬──Group(groupname)────────────────────────5 ├─DB2Conn(name)──────┤ ├─DB2Entry(name)─────┤ ├─DB2Tran(name)──────┤ ├─DOctemplate(name)──┤ ├─Enqmodel(name)─────┤ ├─File(name)─────────┤ ├─Journalmodel(name)─┤ ├─Lsrpool(name)──────┤ ├─Mapset(name)───────┤ ├─PARTItionset(name)─┤ ├─PARTNer(name)──────┤ ├─PROCesstype(name)──┤ ├─PROFile(name)──────┤ ├─PROGram(name)──────┤ ├─Requestmodel(name)─┤ ├─Sessions(name)─────┤ ├─TCpipservice(name)─┤ ├─TErminal(name)─────┤ ├─TDqueue(name)──────┤ ├─TRANClass(name)────┤ ├─TRANSaction(name)──┤ ├─TSmodel(name)──────┤ └─TYpeterm(name)─────┘ 5──attribute list(new value)──5%

APPEND syntax 55──APpend──LIst(listname1)──To(listname2)──5%

 Copyright IBM Corp. 1989, 1999

197

RDO

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

|

COPY syntax ┌─All────────────────┐ 55──COpy──┼────────────────────┼──Group(groupname)─────────────────────────5 ├─Connection(name)───┤ ├─DB2Conn(name)──────┤ ├─DB2Entry(name)─────┤ ├─DB2Tran(name)──────┤ ├─DOctemplate(name)──┤ ├─Enqmodel(name)─────┤ ├─File(name)─────────┤ ├─Journalmodel(name)─┤ ├─Lsrpool(name)──────┤ ├─Mapset(name)───────┤ ├─PARTItionset(name)─┤ ├─PARTNer(name)──────┤ ├─PROCesstype(name)──┤ ├─PROFile(name)──────┤ ├─PROGram(name)──────┤ ├─Requestmodel(name)─┤ ├─Sessions(name)─────┤ ├─TCpipservice(name)─┤ ├─TDqueue(name)──────┤ ├─TErminal(name)─────┤ ├─TRANClass(name)────┤ ├─TRANSaction(name)──┤ ├─TSmodel(name)──────┤ └─TYpeterm(name)─────┘

| |

| | |

|

5──┬─AS(newname)───────────────────┬──┬─────────┬──5% ├─TO(newgroupname)──────────────┤ ├─Replace─┤ └─AS(new-name) TO(newgroupname)─┘ └─MErge───┘

198

CICS User’s Handbook

RDO

USERDEFINE syntax 55──USerdefine──┬─Connection(name)───┬──Group(groupname)───────────────────5 ├─DB2Conn(name)──────┤ ├─DB2Entry(name)─────┤ ├─DB2Tran(name)──────┤ ├─DOctemplate(name)──┤ ├─Enqmodel(name)─────┤ ├─File(name)─────────┤ ├─Journalmodel(name)─┤ ├─Lsrpool(name)──────┤ ├─Mapset(name)───────┤ ├─PARTItionset(name)─┤ ├─PARTNer(name)──────┤ ├─PROCesstype(name)──┤ ├─PROFile(name)──────┤ ├─PROGram(name)──────┤ ├─Requestmodel(name)─┤ ├─Sessions(name)─────┤ ├─TCpipservice(name)─┤ ├─TDqueue(name)──────┤ ├─TErminal(name)─────┤ ├─TRANClass(name)────┤ ├─TRANSaction(name)──┤ ├─TSmodel(name)──────┤ └─TYpeterm(name)─────┘ 5──attribute list(newvalue)──5%

DEFINE syntax

| |

| | |

|

55──DEFine──┬─Connection(name)───┬──Group(groupname)───────────────────────5 ├─DB2Conn(name)──────┤ ├─DB2Entry(name)─────┤ ├─DB2Tran(name)──────┤ ├─DOctemplate(name)──┤ ├─Enqmodel(name)─────┤ ├─File(name)─────────┤ ├─Journalmodel(name)─┤ ├─LSRpool(name)──────┤ ├─Mapset(name)───────┤ ├─PARTItionset(name)─┤ ├─PARTNer(name)──────┤ ├─PROCesstype(name)──┤ ├─PROFile(name)──────┤ ├─PROGram(name)──────┤ ├─Requestmodel(name)─┤ ├─Sessions(name)─────┤ ├─TCpipservice(name)─┤ ├─TDqueue(name)──────┤ ├─TErminal(name)─────┤ ├─TRANClass(name)────┤ ├─TRANSaction(name)──┤ ├─TSmodel(name)──────┤ └─TYpeterm(name)─────┘ 5──attribute list(newvalue)──5%

Chapter 4. Resource definition online

199

RDO

DELETE syntax 55──DELete──┬─All────────────────┬──Group(groupname)─┬────────┬───5% ├─Connection(name)───┤ └─REMove─┘ ├─DB2Conn(name)──────┤ ├─DB2Entry(name)─────┤ ├─DB2Tran(name)──────┤ ├─DOctemplate(name)──┤ ├─Enqmodel(name)─────┤ ├─File(name)─────────┤ ├─Journalmodel(name)─┤ ├─Lsrpool(name)──────┤ ├─Mapset(name)───────┤ ├─PARTItionset(name)─┤ ├─PARTNer(name)──────┤ ├─PROCesstype(name)──┤ ├─PROFile(name)──────┤ ├─PROGram(name)──────┤ ├─Requestmodel(name)─┤ ├─Sessions(name)─────┤ ├─TCpipservice(name)─┤ ├─TDqueue(name)──────┤ ├─TErminal(name)─────┤ ├─TRANClass(name)────┤ ├─TRANSaction(name)──┤ ├─TSmodel(name)──────┤ └─TYpeterm(name)─────┘

|

| |

| | |

|

DISPLAY syntax 55──DISplay──┬─List(listname)──┬──────────────────┬─────────────────┬──5% │ └─Group(groupname)─┘ │ └─Group(groupname)──┬────────────────────┬──┬────────┬─┘ ├─ALl(name)──────────┤ └─REname─┘ ├─Connection(name)───┤ ├─DB2Conn(name)──────┤ ├─DB2Entry(name)─────┤ ├─DB2Tran(name)──────┤ ├─DOctemplate(name)──┤ ├─Enqmodel(name)─────┤ ├─File(name)─────────┤ ├─Journalmodel(name)─┤ ├─Lsrpool(name)──────┤ ├─Mapset(name)───────┤ ├─PARTItionset(name)─┤ ├─PARTNer(name)──────┤ ├─PROCesstype(name)──┤ ├─PROFile(name)──────┤ ├─PROGram(name)──────┤ ├─Requestmodel(name)─┤ ├─Sessions(name)─────┤ ├─TCpipservice(name)─┤ ├─TDqueue(name)──────┤ ├─TErminal(name)─────┤ ├─TRANClass(name)────┤ ├─TRANSaction(name)──┤ ├─TSmodel(name)──────┤ └─TYpeterm(name)─────┘

| |

| | |

|

200

CICS User’s Handbook

RDO

EXPAND syntax

| |

| | |

|

55──EXPand──┬─List(listname)──┬──────────────────┬─────────────────┬──5% │ └─Group(groupname)─┘ │ └─Group(groupname)──┬────────────────────┬──┬────────┬─┘ ├─ALl(name)──────────┤ └─REname─┘ ├─Connection(name)───┤ ├─DB2Conn(name)──────┤ ├─DB2Entry(name)─────┤ ├─DB2Tran(name)──────┤ ├─DOctemplate(name)──┤ ├─Enqmodel(name)─────┤ ├─File(name)─────────┤ ├─Journalmodel(name)─┤ ├─Lsrpool(name)──────┤ ├─Mapset(name)───────┤ ├─PARTItionset(name)─┤ ├─PARTNer(name)──────┤ ├─PROCesstype(name)──┤ ├─PROFile(name)──────┤ ├─PROGram(name)──────┤ ├─Requestmodel(name)─┤ ├─Sessions(name)─────┤ ├─TCpipservice(name)─┤ ├─TDqueue(name)──────┤ ├─TErminal(name)─────┤ ├─TRANClass(name)────┤ ├─TRANSaction(name)──┤ ├─TSmodel(name)──────┤ └─TYpeterm(name)─────┘

INSTALL syntax | |

| |

| | |

|

55──Install──┬────────────────────┬──┬─Group(groupname)─┬──5% ├─ALl(name)──────────┤ └─List(listname)───┘ ├─Connection(name)───┤ ├─DB2Conn(name)──────┤ ├─DB2Entry(name)─────┤ ├─DB2Tran(name)──────┤ ├─DOctemplate(name)──┤ ├─Enqmodel(name)─────┤ ├─File(name)─────────┤ ├─Journalmodel(name)─┤ ├─Lsrpool(name)──────┤ ├─Mapset(name)───────┤ ├─PARTItionset(name)─┤ ├─PARTNer(name)──────┤ ├─PROCesstype(name)──┤ ├─PROFile(name)──────┤ ├─PROGram(name)──────┤ ├─Requestmodel(name)─┤ ├─TCpipservice(name)─┤ ├─TDqueue(name)──────┤ ├─TErminal(name)─────┤ ├─TRANClass(name)────┤ ├─TRANSaction(name)──┤ ├─TSmodel(name)──────┤ └─TYpeterm(name)─────┘

Chapter 4. Resource definition online

201

RDO

LOCK syntax 55──Lock──┬─Group(groupname)─┬──5% └─List(listname)───┘

MOVE syntax ┌─All────────────────┐ 55──Move──┼────────────────────┼──Group(groupname)─┬────────┬──────────────5 ├─Connection(name)───┤ └─REMove─┘ ├─DB2Conn(name)──────┤ ├─DB2Entry(name)─────┤ ├─DB2Tran(name)──────┤ ├─DOctemplate(name)──┤ ├─Enqmodel(name)─────┤ ├─File(name)─────────┤ ├─Journalmodel(name)─┤ ├─Lsrpool(name)──────┤ ├─Mapset(name)───────┤ ├─PARTItionset(name)─┤ ├─PROCesstype(name)──┤ ├─PROFile(name)──────┤ ├─PROGram(name)──────┤ ├─Requestmodel(name)─┤ ├─Sessions(name)─────┤ ├─TCpipservice(name)─┤ ├─TDqueue(name)──────┤ ├─TErminal(name)─────┤ ├─TRANClass(name)────┤ ├─TRANSaction(name)──┤ ├─TSmodel(name)──────┤ └─TYpeterm(name)─────┘

|

| |

| | |

|

5──┬─AS(newname)──────────────────┬──┬─────────┬──5% ├─TO(newgroupname)─────────────┤ ├─REPlace─┤ └─AS(newname) TO(newgroupname)─┘ └─MErge───┘

|

REMOVE syntax 55──REMove──Group(groupname)──List(listname)──5%

202

CICS User’s Handbook

RDO

RENAME syntax

| |

| | |

|

|

55──REName──┬────────────────────┬──┬──────────────────┬───────────────────5 ├─ALl(name)──────────┤ └─Group(groupname)─┘ ├─Connection(name)───┤ ├─DB2Conn(name)──────┤ ├─DB2Entry(name)─────┤ ├─DB2Tran(name)──────┤ ├─DOctemplate(name)──┤ ├─Enqmodel(name)─────┤ ├─File(name)─────────┤ ├─Journalmodel(name)─┤ ├─Lsrpool(name)──────┤ ├─Mapset(name)───────┤ ├─PARTItionset(name)─┤ ├─PARTNer(name)──────┤ ├─PROCesstype(name)──┤ ├─PROFile(name)──────┤ ├─PROGram(name)──────┤ ├─REQuestmodel(name)─┤ ├─Sessions(name)─────┤ ├─TCpipservice(name)─┤ ├─TDqueue(name)──────┤ ├─TErminal(name)─────┤ ├─TRANClass(name)────┤ ├─TRANSaction(name)──┤ ├─TSmodel(name)──────┤ └─TYpeterm(name)─────┘ 5──┬─────────────┬──┬──────────────────┬──┬────────┬──5% └─AS(newname)─┘ └─TO(newgroupname)─┘ └─REMove─┘

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

Chapter 4. Resource definition online

203

RDO

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

| |

| | |

|

5──attribute list(newvalue)──5%

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

| |

| | |

|

204

CICS User’s Handbook

CSD

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

ADD syntax 55──ADd──Group(groupname)──LIst(listname)──5%

ALTER syntax

| |

| | |

|

55──ALter──┬─Connection(name)───┬──Group(groupname)────────────────────────5 ├─DB2Conn(name)──────┤ ├─DB2Entry(name)─────┤ ├─DB2Tran(name)──────┤ ├─DOctemplate(name)──┤ ├─Enqmodel(name)─────┤ ├─File(name)─────────┤ ├─Journalmodel(name)─┤ ├─Lsrpool(name)──────┤ ├─Mapset(name)───────┤ ├─PARTItionset(name)─┤ ├─PARTNer(name)──────┤ ├─PROCesstype(name)──┤ ├─PROFile(name)──────┤ ├─PROGram(name)──────┤ ├─Requestmodel(name)─┤ ├─Sessions(name)─────┤ ├─TCpipservice(name)─┤ ├─TDqueue(name)──────┤ ├─TErminal(name)─────┤ ├─TRANClass(name)────┤ ├─TRANSaction(name)──┤ ├─TSmodel(name)──────┤ └─TYpeterm(name)─────┘ 5──attribute list(new value)──5%

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

 Copyright IBM Corp. 1989, 1999

205

CSD

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

DEFINE syntax 55──DEFine──┬─Connection(name)───┬──Group(groupname)───────────────────────5 ├─DB2Conn(name)──────┤ ├─DB2Entry(name)─────┤ ├─DB2Tran(name)──────┤ ├─DOctemplate(name)──┤ ├─Enqmodel(name)─────┤ ├─File(name)─────────┤ ├─Journalmodel(name)─┤ ├─LSRpool(name)──────┤ ├─Mapset(name)───────┤ ├─PARTItionset(name)─┤ ├─PARTNer(name)──────┤ ├─PROCesstype(name)──┤ ├─PROFile(name)──────┤ ├─PROGram(name)──────┤ ├─Requestmodel(name)─┤ ├─Sessions(name)─────┤ ├─TCpipservice(name)─┤ ├─TDqueue(name)──────┤ ├─TErminal(name)─────┤ ├─TRANClass(name)────┤ ├─TRANSaction(name)──┤ ├─TSmodel(name)──────┤ └─TYpeterm(name)─────┘

| |

| | |

|

5──attribute list(newvalue)──5%

206

CICS User’s Handbook

CSD

DELETE syntax |

| |

| | |

|

55──DELete──┬─List(listname)───────────────────────────────────────┬──5% └─Group(groupname)─┬─All────────────────┬──┬────────┬──┘ ├─Connection(name)───┤ └─REMove─┘ ├─DB2Conn(name)──────┤ ├─DB2Entry(name)─────┤ ├─DB2Tran(name)──────┤ ├─DOctemplate(name)──┤ ├─Enqmodel(name)─────┤ ├─File(name)─────────┤ ├─Journalmodel(name)─┤ ├─Lsrpool(name)──────┤ ├─Mapset(name)───────┤ ├─PARTItionset(name)─┤ ├─PARTNer(name)──────┤ ├─PROCesstype(name)──┤ ├─PROFile(name)──────┤ ├─PROGram(name)──────┤ ├─Requestmodel(name)─┤ ├─Sessions(name)─────┤ ├─TCpipservice(name)─┤ ├─TDqueue(name)──────┤ ├─TErminal(name)─────┤ ├─TRANClass(name)────┤ ├─TRANSaction(name)──┤ ├─TSmodel(name)──────┤ └─TYpeterm(name)─────┘

EXTRACT syntax 55──EXtract──┬─Group(groupname)─┬──┬─USerprogram(DFHxCRFy)─────────────┬───5 └─LIst(listname)───┘ ├─USerprogram(DFHxFORy)─────────────┤ ├─USerprogram(DFHðCBDC)─────────────┤ └─USerprogram(user-written program)─┘ 5───┬─────────┬───5% └─Objects─┘

INITIALIZE syntax 55──INITialize──5%

Chapter 5. DFHCSDUP commands

207

CSD

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

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

REMOVE syntax 55──Remove──Group(groupname)──LIst(listname)──5%

208

CICS User’s Handbook

CSD

SCAN syntax

| |

| | |

|

55──SCAN──┬─Connection(name)───┬──┬──────────────────┬──5% ├─DB2Conn(name)──────┤ └─ALIAS(aliasname)─┘ ├─DB2Entry(name)─────┤ ├─DB2Tran(name)──────┤ ├─DOctemplate(name)──┤ ├─Enqmodel(name)─────┤ ├─File(name)─────────┤ ├─Journalmodel(name)─┤ ├─Lsrpool(name)──────┤ ├─Mapset(name)───────┤ ├─PARTItionset(name)─┤ ├─PARTNer(name)──────┤ ├─PROCesstype(name)──┤ ├─PROFile(name)──────┤ ├─PROGram(name)──────┤ ├─Requestmodel(name)─┤ ├─Sessions(name)─────┤ ├─TCpipservice(name)─┤ ├─TDqueue(name)──────┤ ├─TErminal(name)─────┤ ├─TRANClass(name)────┤ ├─TRANSaction(name)──┤ ├─TSmodel(name)──────┤ └─TYpeterm(name)─────┘

SERVICE syntax 55──Service──FRomcsd(ddname)──LEvel(nnn)──5%

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

VERIFY syntax 55──VERIFY──5%

Chapter 5. DFHCSDUP commands

209

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 55──FEPI ALLOCATE──PASSCONVID(data-value)──5%

Conditions: INVREQ

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

Conditions: INVREQ

FEPI AP NOOP 55──FEPI AP NOOP──5%

Conditions: INVREQ

Previously allocated conversation

 Copyright IBM Corp. 1989, 1999

211

FEPI programming

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

Conditions: INVREQ

212

CICS User’s Handbook

FEPI programming

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

Conditions: INVREQ

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

Conditions: INVREQ

Chapter 6. FEPI command reference

213

FEPI programming

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

Conditions: INVREQ

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

Conditions: INVREQ

214

CICS User’s Handbook

FEPI programming

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

Conditions: INVREQ

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

Conditions: INVREQ

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

Conditions: INVREQ

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

Conditions: INVREQ

Chapter 6. FEPI command reference

215

FEPI programming

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

Conditions: INVREQ

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

Conditions: INVREQ

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

Conditions: INVREQ

216

CICS User’s Handbook

FEPI programming

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

Conditions: INVREQ

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

Conditions: INVREQ

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

Conditions: INVREQ

Chapter 6. FEPI command reference

217

FEPI programming

FEPI system programming

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

Conditions: INVREQ, NOTAUTH

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

Conditions: INVREQ, NOTAUTH

FEPI DISCARD NODELIST 55──FEPI DISCARD──NODELIST(data-area)──NODENUM(data-value)──5%

Conditions: INVREQ, NOTAUTH

FEPI DISCARD POOL 55──FEPI DISCARD──POOL(data-value)──5%

Conditions: INVREQ, NOTAUTH

FEPI DISCARD PROPERTYSET 55──FEPI DISCARD──PROPERTYSET(data-value)──5%

Conditions: INVREQ, NOTAUTH

218

CICS User’s Handbook

FEPI programming

FEPI DISCARD TARGETLIST 55──FEPI DISCARD──TARGETLIST(data-area)──TARGETNUM(data-value)──5%

Conditions: INVREQ, NOTAUTH

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

Conditions: END, ILLOGIC, INVREQ, NOTAUTH

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

Conditions: END, ILLOGIC, INVREQ, NOTAUTH

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

Conditions: END, ILLOGIC, INVREQ, NOTAUTH

Chapter 6. FEPI command reference

219

FEPI programming

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

Conditions: END, ILLOGIC, INVREQ, NOTAUTH

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

Conditions: END, ILLOGIC, INVREQ, NOTAUTH

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

Conditions: INVREQ, NOTAUTH

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

Conditions: INVREQ, NOTAUTH

220

CICS User’s Handbook

FEPI programming

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

Conditions: INVREQ, NOTAUTH

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

Conditions: INVREQ, NOTAUTH

Chapter 6. FEPI command reference

221

FEPI programming

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

Conditions: INVREQ, NOTAUTH

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

Conditions: INVREQ, NOTAUTH

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

Conditions: INVREQ, NOTAUTH

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

Conditions: INVREQ, NOTAUTH

222

CICS User’s Handbook

FEPI programming

FEPI SP NOOP 55──FEPI SP NOOP──5%

Conditions: INVREQ, NOTAUTH

Chapter 6. FEPI command reference

223

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

 Copyright IBM Corp. 1989, 1999

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

225

CVDA

|

|

| |

| |

|

Value

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

226

CICS User’s Handbook

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

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

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

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

227

CVDA

|

|

| |

|

|

Value

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

228

CICS User’s Handbook

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

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

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

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

229

CVDA

| |

|

|

Value

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

230

CICS User’s Handbook

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

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

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

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

231

CVDA |

| | |

|

Value

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

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

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

Value

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

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

234

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

CICS User’s Handbook

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

Value |

|

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

CVDA

Value

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

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

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

236

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

CICS User’s Handbook

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

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

Value

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

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

238

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

CICS User’s Handbook

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

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

Value

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

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

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 | | | | | | |

1072 1073 1080 1081 1082 1083 1084

CVDA PROGAUTO FULLAUTO JVM NOJVM DEBUG NODEBUG NONLE370

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

240

CICS User’s Handbook

CVDA sequence 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

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

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

Numeric sequence

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

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

COBOL

C/370

PL/I

ASM

EIBAID EIBATT EIBCALEN

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)

char eibaid[1] char eibatt[1] short int eibcalen

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)

CL1 CL1 H

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

 Copyright IBM Corp. 1989, 1999

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]

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

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

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

Command

Type

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'

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

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 value

Command

Type

X'0422' X'0424' X'0426' X'0428' X'042A' X'042C' X'042E' X'0430' X'0432' X'0434'

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

API API API API API API API API API API

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'

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

EIBFN codes EIBFN value

Command

Type

EIBFN value

X'1006' X'1008' X'100A' X'100C' X'1202' X'1204' X'1206' X'1208' X'1402'

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

API API API API API API API API API

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

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'

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

Command

Chapter 8. EXEC interface block (EIB)

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

245

EIBFN codes EIBFN value

Command

Type

EIBFN value

Command

Type

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'

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

SPI SPI SPI SPI API API API API SPI SPI SPI SPI SPI SPI SPI

X'5C10' X'5E02' X'5E04' X'5E06' X'5E08' X'5E12' X'5E14' X'5E18'

SPI SPI SPI API SPI SPI SPI SPI

X'5E1C' X'5E22' X'5E32' X'6002'

SPI SPI

X'6004' X'6010'

SPI SPI SPI SPI SPI SPI SPI SPI SPI SPI SPI API API

X'6012'

X'6622'

API API API SPI

X'6624' X'6802' X'6804' X'6812'

SPI SPI

X'6814' X'6822'

SPI

X'6824' X'6826'

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

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'

246

CICS User’s Handbook

SPI SPI SPI SPI

X'5E1A'

X'6014' X'6202' X'6204' X'6402' X'6602' X'6604' X'6612' X'6614'

X'6A02' X'6C02' X'6C12'

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

EIBFN codes EIBFN value

Command

Type

EIBFN value

X'6E02' X'6E04' X'7002' X'7004' X'7006'

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

SPI SPI 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

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'

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

Command

Chapter 8. EXEC interface block (EIB)

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

247

EIBFN codes EIBFN value

Command

Type

EIBFN value

X'8C02' X'9002' X'9004' X'9022' X'9042' X'9044' X'9062'

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

API 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

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'

248

CICS User’s Handbook

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

Command

Type SPI SPI SPI SPI SPI SPI SPI SPI SPI SPI SPI SPI SPI SPI SPI SPI SPI SPI SPI SPI SPI SPI

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

EIBRCODE

Condition

ð2 ..

Eð .. .. .. .. .. INVREQ

ð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

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

ð4 1ð C1 C2 Dð D2 D3 D4 D5 Eð E1 E3 E4 E5 E6 E7 E8 EA EB EC ED F1 .. .. .. ..

.. .. .. .. .. .. .. .. .. .. .. .. .. .. .. .. .. .. .. .. .. .. 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

ð6 ð6 ð6 ð6 ð6 ð6 ð6 ð6 ð6 ð6 ð6 ð6 ð6

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

ð1 ð2 ð3 ð5 ð8 ðC ðD ðF 8ð 81 82 83 84

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

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

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

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

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

FILENOTFOUND ILLOGIC1 LOCKED RECORDBUSY INVREQ NOTOPEN DISABLED ENDFILE IOERR1 NOTFND DUPREC NOSPACE DUPKEY

EIBFN

EIBRCODE

Condition

ð6 ð6 ð6 ð6 ð6 ð6

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

85 86 Dð D1 D6 E1

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

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

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

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

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

SUPPRESSED LOADING SYSIDERR3 ISCINVREQ NOTAUTH LENGERR

ð8 ð8 ð8 ð8 ð8 ð8 ð8 ð8 ð8 ð8 ð8 ð8

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

ð1 ð2 ð4 ð8 1ð Cð Dð D1 D6 D7 Eð E1

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

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

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

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

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

QZERO QIDERR IOERR NOTOPEN NOSPACE QBUSY SYSIDERR3 ISCINVREQ NOTAUTH DISABLED INVREQ LENGERR

ðA ðA ðA ðA ðA ðA ðA ðA ðA

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

ð1 ð2 ð4 ð8 2ð Dð D1 D6 E1

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

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

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

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

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

ITEMERR QIDERR IOERR NOSPACE INVREQ SYSIDERR3 ISCINVREQ NOTAUTH LENGERR

ðC .. ðC ..

E1 .. .. .. .. .. LENGERR E2 .. .. .. .. .. NOSTG

ðE ðE ðE ðE ðE

ð1 D6 Eð E1 F1

.. .. .. .. ..

.. .. .. .. ..

.. .. .. .. ..

.. .. .. .. ..

.. .. .. .. ..

.. .. .. .. ..

PGMIDERR NOTAUTH INVREQ LENGERR TERMERR

Chapter 8. EXEC interface block (EIB)

249

EIBRCODE values

EIBFN

EIBRCODE

1ð 1ð 1ð 1ð 1ð 1ð 1ð 1ð 1ð 1ð 1ð 1ð 1ð

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

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

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

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

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

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

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

Condition

EIBFN

EIBRCODE

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

18 ..

.. .. 1ð .. .. .. IGREQID

1A 1A 1A 1A 1A 1A 1A 1A 1A

Eð ð4 ð8 ðC 1ð E1 .. .. ..

12 .. 12 .. 12 ..

32 .. .. .. .. .. ENQBUSY Eð .. .. .. .. .. INVREQ E1 .. .. .. .. .. LENGERR

14 14 14 14 14 14 14

ð1 ð2 ð5 ð6 ð7 ð9 D6

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

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

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

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

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

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

JIDERR INVREQ NOTOPEN LENGERR IOERR NOJBUFSP NOTAUTH

16 ..

ð1 .. .. .. .. .. ROLLEDBACK

18 18 18 18 18 18 18 18 18 18 18 18 18 18 18 18 18 18 18 18

ð1 ð2 ð4 ð8 2ð 4ð 8ð E1 E3 E4 .. .. .. .. .. .. .. .. .. ..

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

250

.. .. .. .. .. .. .. .. .. .. ð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

CICS User’s Handbook

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

.. .. .. .. .. .. 11 2B ..

.. .. .. .. .. .. .. .. 2ð

Condition

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

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

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

INVREQ DSSTAT FUNCERR SELNERR UNEXPIN LENGERR EODS IGREQCD EOC

22 ..

8ð .. .. .. .. .. INVEXITREQ

4A ..

.. .. .. ð1 .. .. ERROR

56 56 56 56 56 56 56 56 56 56 56 56 56 56 56 56

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

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

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

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

ð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

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

ðð ð4 ð8 ðC 1ð 14 18 ..

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

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

.. .. .. .. ..

ðC ðC ðC ðC ðC

xx ðð ð4 ð8 ðC

.. .. .. .. ..

.. .. .. .. ..

.. request was for invalid function .. no session available and NOQUEUE .. mode name not found .. mode name invalid .. task canceled or timed out during allocation .. mode group is out of service .. 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 .. SYSID definition error .. name not that of TCTSE .. name not that of remote TCTSE .. mode name not found .. profile not found

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 ðC ðC

.. xx ðð ð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

Condition

RESP value

Condition

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

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

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

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

Condition

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

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

Condition

RESP2

Meaning

ACQUIRE TERMINAL

INVREQ

2

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

3

4

5 7

8

LENGERR

6

NOTAUTH

100

TERMIDERR

1

ADDRESS

INVREQ

200

The TCTUA option is specified on an ADDRESS command issued in a DPL server program

ASSIGN

INVREQ

1

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

2

3

 Copyright IBM Corp. 1989, 1999

257

RESP2 values Command

Condition

RESP2

Meaning

4

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

5

200

CHANGE PASSWORD

INVREQ

13

18

29

NOTAUTH

2 4 19 22

31

CHANGE TASK

258

USERIDERR

8

INVREQ

1

CICS User’s Handbook

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

The PRIORITY value is outside the range 0–255

RESP2 values Command

Condition

RESP2

Meaning

COLLECT STATISTICS

NOTFND

1

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

2

IOERR

3

INVREQ

4

NOTAUTH

100

101

CONNECT PROCESS

INVREQ

200

CONVERSE

INVREQ

200

CREATE CONNECTION

LENGERR

1

ILLOGIC

2

NOTAUTH

100

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

Chapter 9. RESP2 values and their meanings

259

RESP2 values Command

Condition

INVREQ

RESP2

Meaning

102

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.

n

200

CREATE DB2CONN

LENGERR

1

ILLOGIC

2

INVREQ

n

200

260

CICS User’s Handbook

RESP2 values Command

Condition

RESP2

Meaning

NOTAUTH

100

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

1

ILLOGIC

2

INVREQ

n

200

NOTAUTH

100

Chapter 9. RESP2 values and their meanings

261

RESP2 values Command

Condition

RESP2

Meaning

101

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

1

ILLOGIC

2

INVREQ

n

200

NOTAUTH

100

101

262

CICS User’s Handbook

RESP2 values Command

Condition

RESP2

Meaning

102

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

1

INVREQ

n

200

CREATE ENQMODEL

NOTAUTH

100

LENGERR

1

INVREQ

n

Chapter 9. RESP2 values and their meanings

263

RESP2 values Command

Condition

NOTAUTH

RESP2

Meaning

200

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

100

101

CREATE FILE

LENGERR

1

ILLOGIC

2

NOTAUTH

100

101

INVREQ

264

CICS User’s Handbook

n

RESP2 values Command

CREATE JOURNALMODEL

Condition

RESP2

Meaning

200

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

LENGERR

1

ILLOGIC

2

NOTAUTH

100

INVREQ

n

200

CREATE LSRPOOL

LENGERR

1

ILLOGIC

2

NOTAUTH

100

Chapter 9. RESP2 values and their meanings

265

RESP2 values Command

Condition

RESP2

Meaning

INVREQ

n

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

1

ILLOGIC

2

NOTAUTH

100

101

INVREQ

n

200

266

CICS User’s Handbook

RESP2 values Command

Condition

RESP2

Meaning

CREATE PARTITIONSET

LENGERR

1

ILLOGIC

2

NOTAUTH

100

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

101

INVREQ

n

200

CREATE PARTNER

LENGERR

1

ILLOGIC

2

NOTAUTH

100

Chapter 9. RESP2 values and their meanings

267

RESP2 values Command

Condition

RESP2

Meaning

INVREQ

n

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

1

ILLOGIC

2

NOTAUTH

100

INVREQ

n

200

CREATE PROGRAM

268

LENGERR

CICS User’s Handbook

1

RESP2 values Command

Condition

RESP2

Meaning

ILLOGIC

2

NOTAUTH

100

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

101

INVREQ

n

200

CREATE REQUESTMODEL

LENGERR

1

ILLOGIC

2

NOTAUTH

100

INVREQ

n

Chapter 9. RESP2 values and their meanings

269

RESP2 values Command

CREATE SESSIONS

Condition

RESP2

Meaning

200

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

LENGERR

1

ILLOGIC

2

NOTAUTH

100

102

102

INVREQ

270

CICS User’s Handbook

200

RESP2 values Command

Condition

RESP2

Meaning

CREATE TCPIPSERVICE

INVREQ

n

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

CREATE TDQUEUE

LENGERR

1

NOTAUTH

100

LENGERR

1

ILLOGIC

2

NOTAUTH

100

101

102

Chapter 9. RESP2 values and their meanings

271

RESP2 values Command

Condition

RESP2

Meaning

INVREQ

n

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

1

ILLOGIC

2

NOTAUTH

100

102

INVREQ

272

CICS User’s Handbook

n

RESP2 values Command

CREATE TRANCLASS

Condition

RESP2

Meaning

200

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

LENGERR

1

ILLOGIC

2

NOTAUTH

100

INVREQ

n

200

CREATE TRANSACTION

LENGERR

1

ILLOGIC

2

NOTAUTH

100

Chapter 9. RESP2 values and their meanings

273

RESP2 values Command

Condition

INVREQ

RESP2

Meaning

101

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

n

200

CREATE TSMODEL

LENGERR

1

NOTAUTH

100

101

INVREQ

n

200

CREATE TYPETERM

274

LENGERR

CICS User’s Handbook

1

RESP2 values Command

Condition

RESP2

Meaning

ILLOGIC

2

NOTAUTH

100

INVREQ

n

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

200

DELAY

INVREQ

4 5 6

Hours are out of range Minutes are out of range Seconds are out of range

DELETE

FILENOTFOUND

1

INVREQ

20

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

21

22

Chapter 9. RESP2 values and their meanings

275

RESP2 values Command

Condition

RESP2

Meaning

25

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

Meaning

51

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

278

Condition

RESP2

Meaning

LOADING

104

LOCKED

106

RECORDBUSY

107

ILLOGIC

110

IOERR

120

SYSIDERR

130

DUPKEY

140

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

CICS User’s Handbook

RESP2 values Command

Condition

RESP2

Meaning

DEQ

LENGERR

1

INVREQ

2

The value specified for the LENGTH option is outside the range 1–255 The MAXLIFETIME option has an incorrect CVDA

NOTAUTH

100

DISABLE PROGRAM

101

DISCARD AUTINSTMODEL

MODELIDERR

1

INVREQ

2 3

DISCARD CONNECTION

NOTAUTH

100

SYSIDERR

9

INVREQ

24 25 26 27 28 29 38 39 200

NOTAUTH

100

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

Chapter 9. RESP2 values and their meanings

279

RESP2 values Command

Condition

RESP2

Meaning

DISCARD DB2CONN

INVREQ

2

NOTFND

1

NOTAUTH

100

INVREQ

2

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

3 NOTFND

1

NOTAUTH

100

101

DISCARD DB2TRAN

NOTFND

1

NOTAUTH

100

101

DISCARD DOCTEMPLATE

280

LENGERR

1

NOTAUTH

100

CICS User’s Handbook

RESP2 values Command

Condition

RESP2

Meaning

INVREQ

n

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

DISCARD FILE

NOTFND

1

NOTAUTH

100

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

DISCARD JOURNALNAME

Condition

RESP2

Meaning

NOTAUTH

100

INVREQ

3

JIDERR

1

NOTAUTH

100

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

101

DISCARD PARTNER

PARTNERIDERR

1 5

INVREQ

2 3

DISCARD PROFILE

NOTAUTH

100

PROFILEIDERR

1

INVREQ

2 3 4

NOTAUTH

282

CICS User’s Handbook

100

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

RESP2 values Command

Condition

RESP2

Meaning

DISCARD PROGRAM

INVREQ

1

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

7

NOTAUTH

100

101

DISCARD REQUESTMODEL

DISCARD TCPIPSERVICE

DISCARD TDQUEUE

NOTFND

1

NOTAUTH

100

INVREQ

9

NOTFND

3

NOTAUTH

100

QIDERR

1

INVREQ

11 18 30 31

Chapter 9. RESP2 values and their meanings

283

RESP2 values Command

Condition

NOTAUTH

RESP2

Meaning

200

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

100

101

DISCARD TERMINAL

TERMIDERR

23

INVREQ

33 38 39 40 41 43 44 45 46 200

DISCARD TRANCLASS

284

NOTAUTH

100

TCIDERR

1

CICS User’s Handbook

The transaction class cannot be found

RESP2 values Command

Condition

RESP2

Meaning

INVREQ

2

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

12

DISCARD TRANSACTION

NOTAUTH

100

TRANSIDERR

1

INVREQ

4

13 14

15

NOTAUTH

100

101

DISCARD TSMODEL

NOTFND

1

INVREQ

2 3

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

Chapter 9. RESP2 values and their meanings

285

RESP2 values Command

Condition

RESP2

Meaning

NOTAUTH

100

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

101

DUMP TRANSACTION

SUPPRESSED

1

2

3

NOSPACE

4

NOSTG

5

NOTOPEN

6

OPENERR

7

IOERR

9 10 13

ENABLE PROGRAM

286

INVREQ

13

NOTAUTH

100

CICS User’s Handbook

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

RESP2 values Command

ENDBR

ENQ

ENTER TRACENUM

Condition

RESP2

Meaning

101

The user associated with the task is not authorized to access this particular resource in the way required by this command.

FILENOTFOUND

1

INVREQ

35

ISCINVREQ

70

NOTAUTH

101

ILLOGIC

110

IOERR

120

SYSIDERR

130

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.

LENGERR

1

INVREQ

2

INVREQ

1 2

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

Chapter 9. RESP2 values and their meanings

287

RESP2 values Command

Condition

RESP2

Meaning

3

The user trace master flag is set OFF and EXCEPTION has not been specified FROMLENGTH is outside the range 0–4000 specified

LENGERR

4

EXTRACT ATTRIBUTES (APPC)

INVREQ

200

A distributed program link server application explicitly, or implicitly by default, specified the function-shipping session (its principal facility) on the CONVID option

EXTRACT ATTRIBUTES (MRO)

INVREQ

200

A distributed program link server application explicitly, or implicitly by default, specified the function-shipping session (its principal facility) on the CONVID option

EXTRACT EXIT

NOTAUTH

100

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.

101

EXTRACT PROCESS

INVREQ

200

A distributed program link server application specified the function-shipping session (its principal facility) on the CONVID option

FORMATTIME

INVREQ

1

The ABSTIME option is in an incorrect format

288

CICS User’s Handbook

RESP2 values Command

Condition

RESP2

Meaning

FREE (APPC)

INVREQ

200

A distributed program link server application specified the function-shipping session (its principal facility) on the CONVID option

FREEMAIN

INVREQ

1

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.

2

GETMAIN

HANDLE ABEND

LENGERR

1

NOSTG

2

PGMIDERR

1

2 9

HANDLE AID

INVREQ

200

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

Chapter 9. RESP2 values and their meanings

289

RESP2 values Command

Condition

RESP2

Meaning

INQUIRE AUTINSTMODEL

ILLOGIC

1

MODELIDERR

1

END

2

NOTAUTH

100

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

INVREQ

20

NOTAUTH

100

END

2

ILLOGIC

1

POOLERR

1

INQUIRE AUTOINSTALL

INQUIRE CFDTPOOL

2

NOTAUTH

290

CICS User’s Handbook

100

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

RESP2 values Command

Condition

RESP2

Meaning

INQUIRE CONNECTION

END

2

ILLOGIC

1

NOTAUTH

100

SYSIDERR

1

NOTFND

1

NOTAUTH

100

NOTFND

1

NOTAUTH

100

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

INQUIRE DB2CONN

INQUIRE DB2ENTRY

101 INQUIRE DB2TRAN

NOTFND

1

NOTAUTH

100 101

INQUIRE DELETSHIPPED

NOTAUTH

100

INQUIRE DOCTEMPLATE

END

2

ILLOGIC

1

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

Chapter 9. RESP2 values and their meanings

291

RESP2 values Command

INQUIRE DSNAME

Condition

RESP2

Meaning

MODELIDERR

1

NOTAUTH

100

DSNNOTFOUND

1

END

2

ILLOGIC

1

IOERR

40

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

49

NOTAUTH

100

INQUIRE DUMPDS

NOTAUTH

100

The user associated with the issuing task is not authorized to use this command

INQUIRE ENQMODEL

END

2

NOTFND

1

There are no more resource definitions of this type The ENQMODEL cannot be found

292

CICS User’s Handbook

RESP2 values Command

Condition

RESP2

Meaning

ILLOGIC

1

NOTAUTH

100

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

101

INQUIRE EXCI

END

2

ILLOGIC

1

NOTAUTH

100

101

INQUIRE EXITPROGRAM

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

END

2

There are no more resource definitions of this type

INVREQ

3

The exit point identified by EXIT does not exist

Chapter 9. RESP2 values and their meanings

293

RESP2 values Command

Condition

RESP2

Meaning

ILLOGIC

1

NOTAUTH

100

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

101

INQUIRE FILE

294

PGMIDERR

1

END

2

FILENOTFOUND ILLOGIC

1 1

NOTAUTH

100

CICS User’s Handbook

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

RESP2 values Command

Condition

RESP2

Meaning

101

The user associated with the issuing task is not authorized to access this particular resource in the way required by this command

INQUIRE IRC

NOTAUTH

100

The user associated with the issuing task is not authorized to use this command

INQUIRE JOURNALMODEL

END

2

ILLOGIC

1

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

2

INQUIRE JOURNALNAME

NOTFND

1

NOTAUTH

100

END

2

ILLOGIC

1

2 JIDERR

1

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

Chapter 9. RESP2 values and their meanings

295

RESP2 values Command

Condition

RESP2

Meaning

NOTAUTH

100

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)

101

INQUIRE MODENAME

END

2

ILLOGIC

1

SYSIDERR

1 2

3

NOTAUTH

100

INQUIRE MONITOR

NOTAUTH

100

INQUIRE PARTNER

END

2

296

CICS User’s Handbook

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

RESP2 values Command

Condition

RESP2

Meaning

ILLOGIC

1

PARTNERIDERR

1

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

2

INQUIRE PROFILE

INQUIRE PROGRAM

NOTAUTH

100

END

2

ILLOGIC

1

PROFILEIDERR

1

NOTAUTH

100

END

2

ILLOGIC

1

PGMIDERR

1

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

Chapter 9. RESP2 values and their meanings

297

RESP2 values Command

Condition

RESP2

Meaning

NOTAUTH

100

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

101

INQUIRE REQID

NOTFND

1

ILLOGIC

1

END

2

INVREQ

3

4

INQUIRE REQUESTMODEL

298

NOTAUTH

100

NOTFND

1

CICS User’s Handbook

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

RESP2 values Command

Condition

RESP2

Meaning

ILLOGIC

1

END

2

NOTAUTH

100

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

INQUIRE STATISTICS

NOTAUTH

100

The user associated with the issuing task is not authorized to use this command

INQUIRE STORAGE

NOTAUTH

100

TASKIDERR

1

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

2

INQUIRE STREAMNAME

NOTAUTH

100

END

2

NOTFND

1

ILLOGIC

1

2

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

Chapter 9. RESP2 values and their meanings

299

RESP2 values Command

Condition

RESP2

Meaning

INQUIRE SYSDUMPCODE

END

2

NOTAUTH

100

ILLOGIC

1

NOTFND

1

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

INQUIRE SYSTEM

NOTAUTH

100

The user associated with the issuing task is not authorized to use this command

INQUIRE TASK

TASKIDERR

1

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

2

NOTAUTH

100

INVREQ

1

3

10

300

CICS User’s Handbook

RESP2 values Command

Condition

RESP2

Meaning

INQUIRE TASK LIST

NOTAUTH

100

The user associated with the issuing task is not authorized to use this command

INQUIRE TCLASS

TCIDERR

1

NOTAUTH

100

The named task class cannot be found The user associated with the issuing task is not authorized to use this command

INVREQ

4

NOTAUTH

100

NOTFND

3

ILLOGIC

1

END

2

INVREQ

4

NOTAUTH

5 100

ENDCOND

2

ILLOGIC

1

INQUIRE TCPIP

INQUIRE TCPIPSERVICE

INQUIRE TDQUEUE

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

Chapter 9. RESP2 values and their meanings

301

RESP2 values Command

Condition

RESP2

Meaning

NOTAUTH

100

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

101

QIDERR

1

NORMAL

0

END

2

ILLOGIC

1

NOTAUTH

100

TERMIDERR

1

INQUIRE TRACEDEST

NOTAUTH

100

The user associated with the issuing task is not authorized to use this command

INQUIRE TRACEFLAG

NOTAUTH

100

The user associated with the issuing task is not authorized to use this command

INQUIRE TRACETYPE

NOTFND

1

CICS was initialized without support for at least one of the components listed in the command; trace levels were returned for all other components

INQUIRE TERMINAL

302

CICS User’s Handbook

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

RESP2 values Command

INQUIRE TRANCLASS

Condition

RESP2

Meaning

NOTAUTH

100

The user associated with the issuing task is not authorized to use this command

INVREQ

12

NOTAUTH

100

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

101

INQUIRE TRANDUMPCODE

INQUIRE TRANSACTION

TCIDERR

1

END

2

ILLOGIC

1

NOTAUTH

100

NOTFND

1

END

2

ILLOGIC

1

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

Chapter 9. RESP2 values and their meanings

303

RESP2 values Command

Condition

RESP2

Meaning

TRANSIDERR

1

INVREQ

3

NORMAL

10

NOTAUTH

100

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

101

INQUIRE TSMODEL

END

2

ILLOGIC

1

NOTFND

1

NOTAUTH

100

101

304

CICS User’s Handbook

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

RESP2 values Command

Condition

RESP2

Meaning

INQUIRE TSPOOL

END

2

ILLOGIC

1

NOTFND

1

NOTAUTH

100

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

101

INQUIRE END TSQUEUE/TSQNAME INVREQ

2

1

2

4

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

Chapter 9. RESP2 values and their meanings

305

RESP2 values Command

Condition

RESP2

Meaning

ILLOGIC

1

NOTAUTH

100

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

101

POOLERR

3

QIDERR

1

SYSIDERR

3 4 5

INQUIRE UOW

INQUIRE UOWDSNFAIL

306

END

2

ILLOGIC

1

UOWNOTFOUND

1

NOTAUTH

100

END

2

CICS User’s Handbook

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

RESP2 values Command

INQUIRE UOWENQ

INQUIRE UOWLINK

Condition

RESP2

Meaning

ILLOGIC

1

NOTAUTH

100

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

END

2

ILLOGIC

1

UOWNOTFOUND

1

NOTAUTH

100

END

2

ILLOGIC

1

UOWLNOTFOUND

1

UOWNOTFOUND

1

NOTAUTH

100

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

Chapter 9. RESP2 values and their meanings

307

RESP2 values Command

Condition

RESP2

Meaning

INQUIRE VOLUME

VOLIDERR

1

The program has issued an INQUIRE VOLUME browse command. This command is withdrawn

INQUIRE VTAM

INVREQ

1

NOTAUTH

100

VTAM is not present in the system The user associated with the issuing task is not authorized to use this command

INVREQ

11

NOTAUTH

100

ISSUE ABEND

INVREQ

200

A distributed program link server application specified the function-shipping session (its principal facility) on the CONVID option

ISSUE ABORT

INVREQ

200

A distributed program link server application specified the function-shipping session (its principal facility) on the CONVID option

ISSUE ADD

INVREQ

200

A distributed program link server application specified the function-shipping session (its principal facility) on the CONVID option

ISSUE CONFIRMATION

INVREQ

200

A distributed program link server application specified the function-shipping session (its principal facility) on the CONVID option

INQUIRE WEB

308

CICS User’s Handbook

An invalid value was supplied for one of the options The user associated with the issuing task is not authorized to use this command

RESP2 values Command

Condition

RESP2

Meaning

ISSUE END

INVREQ

200

A distributed program link server application specified the function-shipping session (its principal facility) on the CONVID option

ISSUE ENDFILE

INVREQ

200

A distributed program link server application attempted to send on its function-shipping session, its principal facility

ISSUE ENDOUTPUT

INVREQ

200

A distributed program link server application attempted to send on its function shipping session, its principal facility

ISSUE EODS

INVREQ

200

A distributed program link server application attempted to send on its function shipping session, its principal facility

ISSUE ERASE

INVREQ

200

A distributed program link server application specified the function-shipping session (its principal facility) on the CONVID option

ISSUE ERASEAUP

INVREQ

200

A distributed program link server application specified the function-shipping session (its principal facility) on the CONVID option

ISSUE ERROR

INVREQ

200

A distributed program link server application specified the function-shipping session on the CONVID option

Chapter 9. RESP2 values and their meanings

309

RESP2 values Command

Condition

RESP2

Meaning

ISSUE NOTE

INVREQ

200

A distributed program link server application specified the function-shipping session (its principal facility) on the CONVID option

ISSUE PREPARE

INVREQ

200

A distributed program link server application specified the function-shipping session (its principal facility) on the CONVID option

ISSUE PRINT

INVREQ

200

A distributed program link server application specified the function-shipping session (its principal facility) on the CONVID option

ISSUE QUERY

INVREQ

200

A distributed program link server application specified the function-shipping session (its principal facility) on the CONVID option

ISSUE RECEIVE

INVREQ

200

A distributed program link server application specified the function-shipping session (its principal facility) on the CONVID option

ISSUE REPLACE

INVREQ

200

A distributed program link server application specified the function-shipping session (its principal facility) on the CONVID option

ISSUE RESET

INVREQ

200

A distributed program link server application specified the function-shipping session (its principal facility) on the CONVID option

310

CICS User’s Handbook

RESP2 values Command

Condition

RESP2

Meaning

ISSUE SEND

INVREQ

200

A distributed program link server application specified the function-shipping session (its principal facility) on the CONVID option

ISSUE SIGNAL (APPC)

INVREQ

200

A distributed program link server application specified the function-shipping session (its principal facility) on the CONVID option

ISSUE WAIT

INVREQ

200

A distributed program link server application specified the function-shipping session (its principal facility) on the CONVID option

LINK

INVREQ

8

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

14

Chapter 9. RESP2 values and their meanings

311

RESP2 values Command

Condition

RESP2

Meaning

15

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

312

CICS User’s Handbook

101

RESP2 values Command

Condition

RESP2

Meaning

PGMIDERR

1

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

2 3

Ÿ 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

21

22

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

Chapter 9. RESP2 values and their meanings

313

RESP2 values Command

Condition

RESP2

Meaning

23

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)

24

ROLLEDBACK

29

SYSIDERR

18

20

LOAD

314

TERMERR

17

INVREQ

30

CICS User’s Handbook

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

RESP2 values Command

Condition

RESP2

Meaning

LENGERR

19

NOTAUTH

101

PGMIDERR

1

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

2 3

Ÿ 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

9

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

Chapter 9. RESP2 values and their meanings

315

RESP2 values Command

Condition

RESP2

Meaning

21

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

22

23

24

MONITOR

INVREQ

1 2 3 4 5

6

PERFORM DELETSHIPPED

316

NOTAUTH

CICS User’s Handbook

100

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

RESP2 values Command

Condition

RESP2

Meaning

PERFORM DUMP

SUPPRESSED

1

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

11

NOTAUTH

100

Chapter 9. RESP2 values and their meanings

317

RESP2 values Command

Condition

RESP2

Meaning

PERFORM ENDAFFINITY

INVREQ

25

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

26

32

34

35 36

37

PERFORM RESETTIME

PERFORM SECURITY REBUILD

318

INVREQ

1

NOTAUTH

100

INVREQ

1

No ESM is installed, or the ESM is inactive

5

The ESM is temporarily inactive and cannot perform the action requested

CICS User’s Handbook

There is no clock in the system The user associated with the issuing task is not authorized to use this command

RESP2 values Command

Condition

RESP2

Meaning

IOERR

3

NOTAUTH

100

NORMAL

0

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

4

PERFORM SHUTDOWN

SYSBUSY

3

INVREQ

1

2 3 4 5

6

7

TRANSIDERR

1

NOTAUTH

100

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

Chapter 9. RESP2 values and their meanings

319

RESP2 values Command

Condition

RESP2

Meaning

PERFORM STATISTICS RECORD

IOERR

n

NOTAUTH

100

NOTFND

n

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

320

CICS User’s Handbook

RESP2 values Command

Condition

RESP2

Meaning

POST

INVREQ

4 5 6

Hours are out of range Minutes are out of range Seconds are out of range

PURGE MESSAGE

INVREQ

200

The command was called in a distributed program link server program

QUERY SECURITY

NOTFND

1

The RESID is not valid

2 3

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

5

8

Possible causes include Ÿ RESCLASS not active Ÿ No profile found QIDERR

1

LENGERR

6

INVREQ

7

9 10

READ

FILENOTFOUND

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

Chapter 9. RESP2 values and their meanings

321

RESP2 values Command

Condition

RESP2

Meaning

LENGERR

10

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

Meaning

28

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

324

Condition

RESP2

Meaning

DISABLED

50

NOTOPEN

60

ISCINVREQ

70

NOTFND

80

NOTAUTH

101

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)

CICS User’s Handbook

RESP2 values Command

Condition

RESP2

Meaning

LOADING

104

LOCKED

106

RECORDBUSY

107

ILLOGIC

110

IOERR

120

SYSIDERR

130

DUPKEY

140

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.

Chapter 9. RESP2 values and their meanings

325

RESP2 values Command

Condition

RESP2

Meaning

READNEXT

FILENOTFOUND

1

LENGERR

10

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

11

13

INVREQ

20

INVREQ

25

26

34

326

CICS User’s Handbook

RESP2 values Command

Condition

RESP2

Meaning

37

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

READPREV

328

Condition

RESP2

Meaning

LOCKED

106

RECORDBUSY

107

ILLOGIC

110

IOERR

120

SYSIDERR

130

DUPKEY

140

FILENOTFOUND

1

LENGERR

10

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

CICS User’s Handbook

RESP2 values Command

Condition

RESP2

Meaning

11

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

Meaning

54

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

330

ISCINVREQ

70

NOTFND

80

ENDFILE

90

NOTAUTH

101

LOCKED

106

RECORDBUSY

107

ILLOGIC

110

IOERR

120

CICS User’s Handbook

RESP2 values Command

Condition

RESP2

Meaning

SYSIDERR

130

DUPKEY

140

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

RECEIVE

INVREQ

200

A distributed program link server application specified the function-shipping session (its principal facility) on the CONVID option

RELEASE

PGMIDERR

1

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

2 9

INVREQ

5

6

7

17

Chapter 9. RESP2 values and their meanings

331

RESP2 values Command

RESETBR

Condition

RESP2

Meaning

30

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

FILENOTFOUND

1

INVREQ

25

26

36

42

51

332

ISCINVREQ

70

NOTFND

80

CICS User’s Handbook

RESP2 values Command

Condition

RESP2

Meaning

NOTAUTH

101

ILLOGIC

110

IOERR

120

SYSIDERR

130

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.

RESYNC ENTRYNAME

NOTAUTH

100

The user associated with the issuing task is not authorized to use this command

RETURN

INVREQ

1

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

2

4

Chapter 9. RESP2 values and their meanings

333

RESP2 values Command

Condition

RESP2

Meaning

8

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

30

200

LENGERR

11

26

27

REWRITE

FILENOTFOUND

1

LENGERR

10

12

14

334

CICS User’s Handbook

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

RESP2 values Command

Condition

RESP2

Meaning

INVREQ

30

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

ROUTE

336

Condition

RESP2

Meaning

LOCKED

106

RECORDBUSY

107

ILLOGIC

110

IOERR

120

SYSIDERR

130

DUPREC

150

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

INVREQ

4 5 6

CICS User’s Handbook

Hours are out of range Minutes are out of range Seconds are out of range

RESP2 values Command

Condition

RESP2

Meaning

200

BMS commands are not supported for distributed program link

SEND

INVREQ

200

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

SEND CONTROL

INVREQ

200

A distributed program link server application has attempted to send on its function-shipping session (its principal facility)

SEND MAP

INVREQ

200

Command is not allowed for a distributed program link server program

SEND PAGE

INVREQ

200

Command is not allowed for a distributed program link server program

SEND PARTNSET

INVREQ

200

Command is not allowed for a distributed program link server program

SEND TEXT

INVREQ

200

Command is not allowed for a distributed program link server program

SEND TEXT MAPPED

INVREQ

200

A distributed program link server application has specified the function-shipping session (its principal facility) on the CONVID option

Chapter 9. RESP2 values and their meanings

337

RESP2 values Command

Condition

RESP2

Meaning

SEND TEXT NOEDIT

INVREQ

200

Command is not allowed for a distributed program link server program

SET AUTOINSTALL

INVREQ

1

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

2 4

SET CONNECTION

NOTAUTH

100

PGMIDERR

3

INVREQ

1

2

3

4 5

6

7 8

338

CICS User’s Handbook

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

RESP2 values Command

Condition

RESP2

Meaning

11

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

12 13 14

16

17

18

19

20

21

22

23

25

Chapter 9. RESP2 values and their meanings

339

RESP2 values Command

Condition

RESP2

Meaning

26

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

340

SYSIDERR

9

IOERR NORMAL

10 58

NORMAL

59

CICS User’s Handbook

RESP2 values Command

SET DB2CONN

Condition

RESP2

Meaning

NOTAUTH

100

INVREQ

1

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

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

Meaning

25

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

26

27 28

29

32 33

34 35 36 37 39 40 41 42 43 44 45

342

CICS User’s Handbook

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

RESP2 values Command

Condition

RESP2

Meaning

46

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

Meaning

17

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

18 19

NOTAUTH

100 101 102 103

SET DB2TRAN

NOTFND

1

INVREQ

2 3

4 NOTAUTH

100 101 102 103

SET DELETSHIPPED

NOTFND

1

INVREQ

1 2 3 4

344

CICS User’s Handbook

INTERVALHRS value is not in the range 0-99 INTERVALMINS value is invalid INTERVALSECS value is invalid

RESP2 values Command

SET DSNAME

Condition

RESP2

Meaning

5 6

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

7 8 100

DSNNOTFOUND

1 15

INVREQ

3 10

12

13

14

16

Chapter 9. RESP2 values and their meanings

345

RESP2 values Command

Condition

RESP2

Meaning

17

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

Meaning

39

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:

40

41

42

43

Ÿ For QUIESCED this would result in a deadlock

44

46

Ÿ 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

Chapter 9. RESP2 values and their meanings

347

RESP2 values Command

Condition

IOERR

RESP2

Meaning

47

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

20

21

35

40

48

49

348

CICS User’s Handbook

RESP2 values Command

Condition

RESP2

Meaning

SUPPRESSED

37

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

38

SET DUMPDS

NOTAUTH

100

INVREQ

1 2

Ÿ 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

Chapter 9. RESP2 values and their meanings

349

RESP2 values Command

SET ENQMODEL

Condition

RESP2

Meaning

3

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

IOERR

4

NOTAUTH

100

INVREQ

2

3

SET FILE

IOERR

4

NOTFND

1

NOTAUTH

100

INVREQ

1 2 3 4 5 6 7 8 9 10

350

CICS User’s Handbook

RESP2 values Command

Condition

RESP2

Meaning

11

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

Meaning

31

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

Meaning

42

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

Meaning

46

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

Meaning

54

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

55 56 57

58

59

60

Ÿ 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

Chapter 9. RESP2 values and their meanings

355

RESP2 values Command

Condition

RESP2

Meaning

61

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:

62 63

Ÿ The file attributes do not match those specified when the CFDT was created, or

64

65 66 67

356

FILENOTFOUND

18

NOTAUTH

100

CICS User’s Handbook

Ÿ 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

RESP2 values Command

Condition

IOERR

RESP2

Meaning

101

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

*

*

SET IRC

INVREQ

1

2 4

5 6

7

8

18

NOSTG

9 10

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)

Chapter 9. RESP2 values and their meanings

357

RESP2 values Command

Condition

IOERR

RESP2

Meaning

11

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

12 13 14

15

SET JOURNALNAME

NOTAUTH

100

JIDERR

1 2

3

INVREQ

2 3 4 5 n

358

CICS User’s Handbook

RESP2 values Command

Condition

RESP2

Meaning

IOERR

6

NOTAUTH

100

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

101

SET JOURNALNUM

JIDERR

1

SET MODENAME

SYSIDERR

1 2

INVREQ

3

4 5

6 7 8

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

Chapter 9. RESP2 values and their meanings

359

RESP2 values Command

SET MONITOR

Condition

RESP2

Meaning

9

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

NOTAUTH

100

INVREQ

1 2 3 4 5 6 7

8 9 10

SET NETNAME

NOTAUTH

100

INVREQ

27 29

NOTAUTH

360

CICS User’s Handbook

100

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

RESP2 values Command

Condition

RESP2

Meaning

SET PROGRAM

INVREQ

1

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

SET STATISTICS

Condition

INVREQ

RESP2

Meaning

101

The user associated with the issuing task is not authorized to access this particular resource in the way required by this command

1

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

2 3 4 5 6 7

8 9 10 11

SET SYSDUMPCODE

NOTAUTH

100

NOTFND

1

INVREQ

2 4 5

362

CICS User’s Handbook

RESP2 values Command

Condition

RESP2

Meaning

6

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

7 9 13 14 15

SET SYSTEM

DUPREC

10

IOERR

11

NOSPACE

12

NOTAUTH

100

INVREQ

1 3 5 6 7 9 12

13 14

Chapter 9. RESP2 values and their meanings

363

RESP2 values Command

Condition

RESP2

Meaning

15

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

20 21 22

23

SET TASK

LENGERR

20

NOSTG

16

NOTAUTH

100

TASKIDERR

1 2

INVREQ

3 4 5

SET TCLASS

364

NOTAUTH

100

TCIDERR

1

INVREQ

2

CICS User’s Handbook

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

RESP2 values Command

SET TCPIP

Condition

RESP2

Meaning

NOTAUTH

100

INVREQ

4

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

5

6 11 12

SET TCPIPSERVICE

NOTAUTH

100

INVREQ

4 4 7 8 9 10 11

SET TDQUEUE

NOTFND

12 3

NOTAUTH

100

QIDERR

1

Chapter 9. RESP2 values and their meanings

365

RESP2 values Command

Condition

RESP2

Meaning

INVREQ

2

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

Meaning

35

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

40 IOERR

14

17

NOTAUTH

23

24

25

27

100

101

102

USERIDERR

28

Chapter 9. RESP2 values and their meanings

367

RESP2 values Command

Condition

RESP2

Meaning

SET TERMINAL

INVREQ

1

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

Meaning

29

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

Meaning

46

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

48

50 51

52

54

57

NORMAL

53 58 59 60

SET TRACEDEST

TERMIDERR

23

NOTAUTH

100

INVREQ

1 2 3 4

370

CICS User’s Handbook

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

RESP2 values Command

Condition

RESP2

Meaning

5

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

6

11 IOERR

10

NOSPACE

7

NOSTG

8

9

SET TRACEFLAG

NOTAUTH

100

INVREQ

1 2 3 4 5

SET TRACETYPE

NOTAUTH

100

NOTFND

1

NOTAUTH

100

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

Chapter 9. RESP2 values and their meanings

371

RESP2 values Command

Condition

RESP2

Meaning

SET TRANCLASS

INVREQ

2

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

3

SET TRANDUMPCODE

NOTAUTH

100

TCIDERR

1

NOTFND

1

INVREQ

2 3 4 5 6 7 9 13 14

372

DUPREC

10

IOERR

11

NOSPACE

12

NOTAUTH

100

CICS User’s Handbook

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

RESP2 values Command

Condition

RESP2

Meaning

SET TRANSACTION

TRANSIDERR

1

INVREQ

2

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

3 4

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

RESP2

Meaning

INVREQ

1

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

2 3

4 POOLERR

0

QIDERR

1

SYSIDERR

0

3 5 NOTAUTH

100

101

SET UOW

UOWNOTFOUND

1

INVREQ

3 4

374

CICS User’s Handbook

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

RESP2 values Command

SET UOWLINK

Condition

RESP2

Meaning

NOTAUTH

100

The use of this command is not authorized

UOWLNOTFOUND

1

INVREQ

2

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

3

4

5

6 7

NOTAUTH

100

SET VOLUME

VOLIDERR

1

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

SET VTAM

INVREQ

1

VTAM is not present in the system OPENSTATUS has an invalid CVDA value

2

Chapter 9. RESP2 values and their meanings

375

RESP2 values Command

Condition

RESP2

Meaning

4

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

5 6 7 8

9

10

11

12

13

376

CICS User’s Handbook

RESP2 values Command

Condition

RESP2

Meaning

14

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

16

SET WEB

SIGNOFF

IOERR

n

NOTAUTH

100

INVREQ

11

NOTAUTH

100

INVREQ

1 2

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

Chapter 9. RESP2 values and their meanings

377

RESP2 values Command

Condition

RESP2

Meaning

3

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

4

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

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

RESP2 values Command

Condition

RESP2

Meaning

12

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

13

14 15

18 25 27 28 29

200

USERIDERR

8

30

SPOOLCLOSE

INVREQ

4 8 40

NOSPOOL

4 8

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

Chapter 9. RESP2 values and their meanings

379

RESP2 values Command

SPOOLOPEN INPUT

Condition

RESP2

Meaning

12

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

NOTOPEN

8

NOTFND

1024

ILLOGIC

3

INVREQ

4 8 16 36 40

NOSPOOL

4 8 12

NOTFND

4

1024

NOTOPEN

8

1024

380

CICS User’s Handbook

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

RESP2 values Command

Condition

RESP2

Meaning

OPENERR

4

SPOLBUSY

4

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

8 SPOOLOPEN OUTPUT

ILLOGIC

3

INVREQ

4 8 16 20 36 40

44 48

52

NOSPOOL

4 8 12

NOTFND

4

NOTOPEN

8

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

Chapter 9. RESP2 values and their meanings

381

RESP2 values Command

Condition

RESP2

Meaning

1024

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.

OPENERR

4

SPOLBUSY

4 8

SPOOLREAD

ILLOGIC

3

INVREQ

4 8 12 24 40

NOSPOOL

4 8 12

NOTFND

4

NOTOPEN

8 12 1024

SPOLBUSY

4 8

SPOOLWRITE

382

INVREQ

CICS User’s Handbook

4

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

RESP2 values Command

Condition

NOSPOOL

RESP2

Meaning

8 28 40

Unsupported function FROM missing Subsystem interface already enabled.

4 8 12

NOTOPEN

8 16 1024

SPOLBUSY

4 8

START

INVREQ

4 5 6 11

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

Chapter 9. RESP2 values and their meanings

383

RESP2 values Command

Condition

RESP2

Meaning

12

A START request with the ATTACH option has failed

18

NOTAUTH

7

9

USERIDERR

8

10

STARTBR

384

FILENOTFOUND

1

INVREQ

20

CICS User’s Handbook

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

RESP2 values Command

Condition

RESP2

Meaning

25

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

386

Condition

RESP2

Meaning

NOTOPEN

60

ISCINVREQ

70

NOTFND

80

NOTAUTH

101

LOADING

104

LOCKED

106

ILLOGIC

110

IOERR

120

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

CICS User’s Handbook

RESP2 values Command

Condition

RESP2

Meaning

SYSIDERR

130

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

INVREQ

200

SYNCPOINT ROLLBACK

INVREQ

200

UNLOCK

FILENOTFOUND

1

INVREQ

47

DISABLED NOTOPEN

50 60

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

Chapter 9. RESP2 values and their meanings

387

RESP2 values Command

VERIFY PASSWORD

Condition

RESP2

Meaning

ISCINVREQ

70

NOTAUTH

101

ILLOGIC (VSAM and CICS-maintained data tables)

110

IOERR

120

SYSIDERR

130

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.

NOTAUTH

2 3

USERIDERR

19 8

INVREQ

13

18

29

32

388

CICS User’s Handbook

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

RESP2 values Command

Condition

RESP2

Meaning

WAIT CONVID

INVREQ

200

Command not supported for distributed program link when it refers to the principal facility

WAIT EVENT

INVREQ

2

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

3

4

6

WAIT EXTERNAL

INVREQ

1

2 3 4

5

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

Chapter 9. RESP2 values and their meanings

389

RESP2 values Command

Condition

RESP2

Meaning

6

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

WAIT TERMINAL

INVREQ

200

A distributed program link server application specified the function-shipping session (its principal facility) on the CONVID option

WAITCICS

INVREQ

1

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

3 4

5

6

WRITE

390

FILENOTFOUND

CICS User’s Handbook

1

RESP2 values Command

Condition

RESP2

Meaning

LENGERR

10

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

Meaning

51

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

392

CICS User’s Handbook

101

RESP2 values Command

Condition

RESP2

Meaning

LOADING

104

SUPPRESSED

105

LOCKED

106

RECORDBUSY

107

ILLOGIC

110

IOERR

120

SYSIDERR

130

DUPREC

150

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

Chapter 9. RESP2 values and their meanings

393

RESP2 values Command

Condition

RESP2

Meaning

WRITE OPERATOR

INVREQ

1

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

2 3 4 5 6

XCTL

EXPIRED

7

LENGERR

8

PGMIDERR

1

2 3

9

394

CICS User’s Handbook

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

RESP2 values Command

Condition

RESP2

Meaning

21

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

Meaning

26

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

396

CICS User’s Handbook

101

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

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

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

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

RESP Value

EIBRCODE

Abend

INVEXITREQ NOTAUTH

63 70

80 46

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

Code

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

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

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

9E 10 90 90 4C 10 92 10

400

CICS User’s Handbook

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

|

| |

| |

|

| | |

|

Command

Code

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

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

Chapter 10. EXEC interface block (EIB) response and function codes

401

|

|

| |

| |

|

Command

Code

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

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

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

Command

16 22 22 22 30 30

RESYNC ENTRYNAME ENABLE PROGRAM DISABLE PROGRAM EXTRACT EXIT CREATE PROFILE CREATE TYPETERM

04 02 04 06 0A 0C

402

CICS User’s Handbook

| | | | | | |

Code

Command

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

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

Command

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

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

Command

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

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 Ÿ DFH messages

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

Code

Command

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

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

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

DFHZCNR

56

DFHCSDUP

51

DFHCSDUP

7x

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)

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

EM The Event Manager domain ER The user backout program EX The external CICS interface FC The file control component FE The FE terminal test program component IC

The interval control program

IN

The indoubt testing tool

IR

The interregion component

JC The online journal control component KC The transaction/profile manager KE The kernel domain LD The loader domain

CP The CPI Communications component

LG The logger domain

CR The ISC remote scheduler component

MC The BMS message control program component

CZ The CICS class libraries domain

ME The message domain

DB The CICS database control component DD The directory manager DM The domain manager domain DS The dispatcher domain DU The dump domain

408

CICS User’s Handbook

LM The lock manager 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

DFH messages PC The program control program component

TC The terminal control program component

PD The print dump exit routine DFHPDX

TD The transient data component

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

TF

The terminal facility manager

TI

The timer domain

TM The system termination program component TO The terminal object resolution program component TP The BMS terminal page retrieval program component TR The trace domain TS The temporary storage domain

RT The ISC transaction routing component

UP The measured usage license charging support macro

RU The recovery utility program

US The user domain

RX The RRS-coordinated EXCI domain

WB The CICS Web Interface

SH The Scheduler domain SI

The system initialization component

XA The XRF alternate component XC The XRF CICS availability manager XG The XRF general component

SK The sub task control program component

XM The transaction manager

SM The storage manager domain

XO The XRF CICS availability manager

SN The signon component SO The CICS sockets domain SR The system recovery component

XQ The shared temporary storage queue pool server XS The CICS security component

ST The statistics domain

ZC The terminal control working set component

SZ The front end programming interface (FEPI)

ZE The TCP error message writer component

ZN The syncpoint component Thus the CICS message DFHAP0002 is issued from the application domain, identified by the two-character identifier AP.

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

Immediate action (for example, mount a tape)

D

Immediate decision (reply to a request, for example, enter “GO” or “CANCEL”)

E

Eventual – action is required, but does not have to be taken immediately

I

No action required (If issued via the message domain, these messages 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

Error. Something has gone wrong and action is required of the user before CICS processing can continue.

I

Information only. No action is required.

W

Warning. Something may have gone wrong, a program loop for example, but CICS processing continues.

S

Severe error. Something serious has gone wrong and immediate action 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

416

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

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

 Copyright IBM Corp. 1989, 1999

*C1* *C2* *C3* *C4* *C5* *C6* *C7* *C8* *C9* *4A* *4B* *4C*

LPA OPID PA1 PA2 PA3

*7E* *E6* *6C* *6E* *6B*

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

is the 2-character code assigned by CICS to identify the module that detected an error.

y

is the 1-character alphanumeric code assigned by CICS.

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

Module

AACA AALM

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

AALN AALO AALP AALQ AALR AALS AALT AALU AAL1 AAL2 AAL3 AAL4 AAL6 AAL7 AAMA AAMC AAMD AAMF AAMG AAMH AAMI AAMJ

Explanation

 Copyright IBM Corp. 1989, 1999

421

Abend codes Abend

Module

Explanation

AAMK

DFHAMP

AAMN

DFHAMP

AAMO AAMP

DFHAMP DFHAMP

AAMQ

DFHAMP

AAMS

DFHAMP

AAMT

DFHAMP

AAMZ

DFHAMP

AAM1

DFHAMP

AAM2

DFHAMP

AAOA AAOB AAOC

DFHCPI DFHCPI DFHCPARH

AAOD

DFHCPCBI

AAOE

DFHCPCBA

AAOF

DFHCPCBS

AAOG AAOH

DFHCPCBA DFHCPCOJ

AAOI AAOJ

DFHCPCRI, DFHCPCRW DFHCPIC

AAOK

DFHCPIC

AAOL

DFHCPCLR

AAOM

AAOO

DFHCPCLR, DFHCPSRH DFHCPCLR, DFHCPCLC DFHCPARH

AAOP

DFHCPCFS

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

AAON

422

CICS User’s Handbook

Abend codes Abend

Module

Explanation

AAOQ

DFHCPCFS

AAOR

DFHCPIC

AAOS

DFHCPIC

AAOT

DFHCPCBI

AAOU

DFHCPCBI

AAOV AAOW AAOX

DFHCPCFS DFHCPCLC DFHCPIC

AAOY

DFHCPCRB

AAOZ

DFHCPCRB

AAO2

DFHCPCBA

AAO3 AAO4 AAO5

AAO7

DFHCPI DFHCPCLR DFHCPCBA, DFHCPCBI, DFHCPCBS DFHCPSRH

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

AAO8

DFHCPSRH

AAO9 ABAC

DFHCPCLR DFHBASP

ABAD

DFHBASP

ABAE

DFHEIBAM

ABAF

DFHEIBAM

ABLA

DFHMCP, DFHMCPE, DFHM32, DFHPBP, DFHRLR DFHMCP, DFHMCPE, DFHM32, DFHPBP, DFHRLR

ABLB

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

Error on call to SM domain

Chapter 13. Transaction abend codes

423

Abend codes Abend

Module

Explanation

ABMA

DFHPBP, DFHMCP DFHPBP, DFHMCP DFHMCX DFHMCP

TIOA = 0 or < (storage accounting length - 12)

ABMB

ABMC ABMD ABME ABMF ABMG ABMI

ABML ABMM ABMO

ABMQ ABMR ABMU

DFHTPP, DFHTPR DFHTPP, DFHTPR DFHPBP DFHMCP, DFHTPQ DFHMCP, DFHMCX, DFHMCY DFHRLR DFHPBP DFHMCP, DFHMCX, DFHMCY DFHQRY

ABM1

DFHTPR DFHMCP, DFHEMS DFHRLR DFHPBP DFHMCP, DFHMCX, DFHMCY DFHMCP, DFHMCX, DFHMCY DFHRLR

ABM2 ABM3

DFHMCP DFHMCP

ABM4

DFHMCP, DFHTPP DFHMCP, DFHTPR DFHMCP DFHPBP DFHPBP DFHPBP

ABMV ABMX ABMZ

ABM0

ABM5 ABM6 ABM7 ABM8 ABM9

424

CICS User’s Handbook

Cursor position larger than current screen size

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

Terminal control locate routine received invalid data Invalid map specified Not output map

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

Map could not be located

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

Abend codes Abend

Module

Explanation

ABNA ABNB ABNC ABNE

DFHTPS DFHTPS DFHTPS DFHTPS

ABNF

DFHTPS

ABNG ABNH ABNI ABNJ ABNK ABRC

DFHTPS DFHTPS DFHTPS DFHTPS DFHTPS DFHBRMS, DFHBRTC DFHBRMS, DFHBRTC DFHBRMS, DFHBRTC DFHBRMS, DFHBRTC DFHBRXM DFHBRXM

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

ABRD ABRE ABRF ABRG ABRH ABRI ABRJ ABRK ABRN

ABRQ ABRR ABRS ABRY

DFHBRXM DFHBRXM DFHBRXM DFHBRIC, DFHBRMS, DFHBRSP, DFHBRTC DFHBRMS, DFHBRTC DFHBRXM DFHBRXM

ABR3

DFHBRMS, DFHBRTC DFHBRIC, DFHBRMS, DFHBRSP, DFHBRTC, DFHXMBR DFHEMS

ABSA

DFHTBS

ABXA ABXC

DFH0CBRF DFH0CBRE

ABRZ

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

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

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

Module

ABXD

DFH0CBRE

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

426

Explanation

Error when SYNCPOINT ROLLBACK request issued by bridge exit DFH0CBAE,DFH0CBRE No data passed on BRDATA parameter of START command DFH0CBAE,DFH0CBRE,DFH0CBAI Error detected by bridge exit inputting next message DFH0CBAE,DFH0CBRE Error detected by bridge exit outputting next message DFH0CBRF No data available in message - transaction is non conversational DFH0CBAE,DFH0CBRE Message received by bridge exit exceeds maximum message size DFH0CBAE,DFH0CBRE Bridge exit detected error in MQCIH passed by client application DFH0CBAE,DFH0CBRE Bridge exit detected error in data passed on BRDATA parameter DFH0CBAE,DFH0CBRE,DFH0CBRF Bridge exit called with unsupported function or 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 Bridge exit called with invalid BRXA-HEADER storage overwrite DFH0CBAE,DFH0CBRE,DFH0CBRF Bridge exit called with invalid BRXA-TRANSACTION-AREA - storage overwrite DFH0CBAE,DFH0CBRE,DFH0CBRF Bridge exit called with unsupported BRXA-COMMAND-AREA - storage overwrite DFH0CBAE,DFH0CBRE,DFH0CBRF Bridge exit called without a user-area - error in bridge exit DFH0CBAE,DFH0CBRE,DFH0CBRF Bridge exit called with invalid user-area - storage 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

CICS User’s Handbook

Abend codes Abend

Module

Explanation

ACAM ACCx

DFHECBAM

ACFA ACFB

DFHFCDL DFHEIFC

ACFC

DFHEIFC

ACFD

DFHFCDL

ACFE ACHA ACHB ACHC

DFHFCDL DFHCHS DFHCHS DFHCHS

ACHD

DFHCHS

ACHE ACHF ACHG ACHH ACHI ACHJ

DFHCHS DFHCHS DFHCHS DFHCHS DFHCHS DFHCHS

ACHK ACHL ACHM ACHN ACHO ACHP ACHR

DFHCHS DFHCHS DFHCHS DFHCHS DFHCHS DFHCHS DFHCHS

ACHS

DFHCHS

ACL0 ACL1

ICCGLBIC ICCGLBIC

ACL2

ICCRESEC

ACL3

ICCRESIC

ACL4 ACL5

ICCGLIBC ICCBASEC

ACL6

ICCBASEC

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

Chapter 13. Transaction abend codes

427

Abend codes Abend

Module

Explanation

ACL7

ICCGLBIC

ACL8

ICCGLBIC

ACL9

ICCRESIC

ACLA

ICCGLIBC

ACLB

ICCGLIBC

ACLC

ICCGLIBC

ACLD

ICCGLIBC

ACLE

ICCGLIBC

ACLF

ICCGLIBC

ACLG

ICCGLIBC

ACLH

ICCBASEC

ACNA ACNB ACN1 ACN2 ACN3 ACN4 ACN5

DFHCCNV DFHCCNV DFHCCNV DFHCCNV DFHCCNV DFHCCNV DFHCCNV

ACN6

DFHCCNV

ACN7

DFHCCNV

ACN8

DFHCCNV

ACN9 ACP1 ACP2 ACQA

DFHCCNV DFHCPY DFHCPY DFHCLS5

ACQB

DFHCLS5

ACQC

DFHCLS5

ACRA

DFHAPRT

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

428

CICS User’s Handbook

Abend codes Abend

Module

Explanation

ACRB

DFHAPRT

ACRC ACRD ACRE ACRF ACRG

DFHAPRT DFHAPRT DFHAPRT DFHAPRT DFHAPRT

ACRH ACRI

ACRK

DFHAPRT DFHAPRT, DFHEPC DFHAPRT, DFHEPC DFHAPRT

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

ACRL ACRM ACRO ACRP ACSA

DFHAPRT DFHAPRT DFHCRQ DFHAPRT DFHCRS

ACSB ACSC ACSD ACSE ACSF

DFHCRS DFHCRS DFHCRS DFHCRS DFHCRS

ACSG ACSH ACSI

DFHCRS DFHCRS DFHCRS

ACSJ ACSL ACSM ACSN ACTA

DFHCRS DFHCRS DFHCRS DFHCRS DFHZTSP

ACTB ACTC ACTD

DFHZTSP DFHZTSP DFHZTSP

ACTE ACTF ACTG

DFHZTSP DFHZTSP DFHZTSP

ACTH

DFHZISP

ACTI

DFHCRT

ACRJ

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

Module

Explanation

ACTJ ACTK ACTL ACUA ACUB

DFHCRT DFHZISP DFHZISP DFHZXRL DFHZXRL

ACUC ACUD

DFHZXRL DFHZXRL

ACUE

DFHZXRL

ACUF ACUG

DFHZXRL DFHZXRL

ACUH ACUI ACUJ ACUK ACUL ACUM

DFHZXRL DFHZXRL DFHZXRL DFHZXRL DFHZXRL DFHZXRL

ACUO ACUP ACUQ ACUR ACUS ACUT ACUV ACUW ACUX ACUY ACUZ ACU0 ACU1 ACU2 ACU3

DFHZXRL DFHZXRL DFHZXRL DFHZXRL DFHZXRL DFHZXRL DFHZXRL DFHZXRL DFHZXRL DFHZXRL DFHZXRL DFHZXRL DFHZXRL DFHZXRL DFHZXRL

ACU4 ACU5 ACU6 ACU7

DFHZXRL DFHZXRL DFHZXRL DFHZXRL

ACU8

DFHZXRL

ACU9

DFHZXRL

ACVA ACVB

DFHZXRT DFHZXRT

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

Module

Explanation

ACVC ACVD ACVE ACVF ACVG ACVH ACVK ACVL ACVM ACVN ACVO ACVP ACVQ ACVR ACWA

DFHZXRT DFHZXRT DFHZXRT DFHZXRT DFHZXRT DFHZXRT DFHZXRT DFHZXRT DFHZXRT DFHZXRT DFHZXRT DFHZXRT DFHZXRT DFHZXRT DFHCWTO

ACXA ADCA ADCB ADCC ADCD ADCE ADCI ADCJ ADCP ADCQ ADCR ADCS

DFHCXCU DFHDLIDP DFHDLIDP DFHDLIDP DFHDLIDP DFHDLIDP DFHDLIDP DFHDLIDP DFHDLIDP DFHDLIDP DFHDLIDP DFHDBAT

ADCT

DFHDBCT

ADDA

ADDI ADDJ

DFHDBME, DFHDLI, DFHDLIDP DFHDBCON, DFHDBDSC DFHDBCON, DFHDBDI DFHDBCT DFHDBCON

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

ADEF ADIR ADLE

DFHCLS3 DFHDIP DFHDLIRP

ADLF ADLG

DFHDLIRP DFHDLIRP

ADDB ADDC

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

Module

Explanation

ADLP ADMA ADMB

DFHDLIRP DFHDBCR DFHDBCR

ADMD

DFHDBCR

ADPL

ADPM

DFHEIP, DFHCPIR, DFHDLI DFHDLI

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

ADXA

DFHDXCU

ADXB

DFHDXCU

AD2A AD2B AD2C

DFHD2EX1 DFHD2EX1 DFHD2EX1

AD2D

DFHD2EX1

AD2E

DFHD2EX1

AD2F

DFHD2EX1

AD2G

DFHD2EX1

AD2H

DFHD2EX1

AD2I

DFHD2EX1

AD2J

DFHD2EX1

AD2K

DFHD2EX1

AD2L

DFHD2EX1

AD2M

DFHD2EX1

AD2N

DFHD2EX1

AD2O

DFHD2EX1

432

CICS User’s Handbook

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

Abend codes Abend

Module

Explanation

AD2P

DFHD2EX1

AD2Q AD2R

DFHD2EX1 DFHD2EX1

AD2S

DFHD2EX1

AD2T

DFHD2EX1

AD2U

DFHD2EX1

AD2V

DFHD2EX1

AD2W

DFHD2EX1

AD2X

DFHD2EX1

AD2Y

DFHD2EX1

AD2Z

DFHD2EX1

AD21

DFHD2EX1

AD22

DFHD2EDF

AD23 AD24 AD25 AD26 AD27

DFHD2EX2 DFHD2EX2 DFHD2CC DFHD2CC DFHD2EX1

AD28

DFHD2EX1

AD29

DFHD2EDF

AD3A AD3B AD3D

DFHD2STR DFHD2STR DFHD2CM1

AD3G

DFHD2CM1

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

Chapter 13. Transaction abend codes

433

Abend codes Abend

Module

Explanation

AD3I

DFHD2CM1

AD3M

DFHD2CM1

AD3P

DFHD2CM1

AD3Q

DFHD2CM1

AD3R

DFHD2STR

AD3S

DFHD2CM1

AD3T

DFHD2EX1

AD3U AD3W

DFHD2EX1 DFHD2STR

AD3X

DFHD2CM1

AD3Z

DFHD2EX1

AEC1

AEC3 AEC4 AEC5 AEC6 AEC7

DFHECIP, DFHECSP, DFHEMTP, DFHESTP, DFHEOTP, DFHEDAP DFHECIP, DFHECSP, DFHEMTP, DFHESTP, DFHEOTP, DFHEDAP DFHAPLI DFHAPLI DFHAPLI DFHAPLI DFHAPLI

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

AEC8

DFHAPLI

AEC9

DFHAPLI

AEDA AEDB

DFHEDFX DFHEDFX

AEC2

434

CICS User’s Handbook

CECI, CEMT, or CEDA/B/C tried to use too small a screen

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

Abend codes Abend

Module

Explanation

AEDC AEDD AEDE AEDF AEDG

DFHEDFX DFHEDFX DFHEDFX DFHEDFX DFHEDFX

AEDH AED1

DFHEDFX DFHEDFP, DFHEDFBR

AED2 AED3 AED4 AED5

DFHEDFX DFHEDFX DFHEDFP DFHEDFD

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

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

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

Chapter 13. Transaction abend codes

435

Abend codes Abend

Module

Explanation

AELB AEMA AEMB AEMP

DFHEGL DFHUEM DFHUEM DFHUEM

AEMQ

DFHUEM

AETA

DFHERM

AETC AETF

DFHERM DFHERM

AETG AETH

DFHERM DFHERM

AETI AETJ AETK AETL AETM

DFHERM DFHERM DFHERM DFHERM DFHRMSY

AETN AETO AETP

DFHRMSY DFHRMSY DFHRMSY

AETQ AETR AETS AEXC AEXF AEXG AEXI AEXJ AEXK AEXL AEXU

DFHRMSY DFHRMSY DFHRMSY DFHEIP DFHEIP DFHEIP DFHEIP DFHEIP DFHEIP DFHEIP DFHEIDTI, DFHEIQDS, DFHEIQSA, DFHEIQSC, DFHEIQSM, DFHEIQSP DFHEIQST, DFHEIQSX DFHEIP DFHEIP DFHEIP DFHxxx

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

436

CICS User’s Handbook

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

Abend codes Abend

Module

Explanation

AEXZ

DFHxxx

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

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

AEY9

DFHEIP, DFHEEI DFHEIP

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

AEZA

AMODE 24 program defined in transaction with TASKDATALOC=ANY

Chapter 13. Transaction abend codes

437

Abend codes Abend

Module

Explanation

AEZB

DFHERM

AEZC

DFHAPLI

AEZD

DFHAPLI

AEZE AEZF AEZG AEZH AEZI AEZJ AEZK AEZL AEZM AEZN AEZO AEZP AEZQ AFCB

DFHEIP DFHEIP DFHEIP DFHEIP DFHEIP DFHEIP DFHEIP DFHEIP DFHEIP DFHEIP DFHEIP DFHEIP DFHEIP DFHEIFC

AFCC

DFHEIFC, DFHDMPCA DFHEIFC

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

AFCD AFCE AFCF AFCG AFCH AFCJ AFCK AFCL AFCM AFCN AFCO AFCR AFCS AFCT

438

DFHEIFC DFHEIFC, DFHDMPCA DFHEIFC, DFHDMPCA DFHEIFC DFHFCU DFHDMPCA, DFHEIFC DFHDTLX DFHDTLX DFHDMPCA, DFHEIFC DFHDTLX DFHEIFC, DFHDMPCA DFHEIFC, DFHDMPCA DFHEIFC, DFHDMPCA

CICS User’s Handbook

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

Abend codes Abend

Module

Explanation

AFCU

Data set in lost locks state

AFC2 AFC7

DFHEIFC, DFHDMPCA DFHEIFC, DFHDMPCA DFHEIFC, DFHDMPCA DFHDMPCA, DFHEIFC DFHDMPCA, DFHEIFC DFHEIFC, DFHDMPCA DFHFCU DFHDMPCA

AFDA

DFHFCQT

AFDB AFDC AFDD AFDE

DFHFCQT DFHFCQT DFHFCQT DFHFCRD

AFDF

DFHFCOR

AFDG AFDH

AICD AICE

DFHFCOR DFHEIFC, DFHDMPCA DFHGMM DFHSRP DFHICP DFHTAJP, DFHICP DFHICP DFHICP

AICF AICG

DFHICP DFHICP

AICH AICJ AICK AICL

DFHICP, DFHEIIC DFHICP DFHEIIC DFHEIIC

AICN AICO

DFHICP DFHICXM

AFCV AFCW AFCY AFCZ AFC0

AGMA AICA AICB AICC

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

Module

Explanation

AICQ

DFHDFST

AICS

DFHDFST

AICT

DFHDFST

AICR AINA

DFHCRR DFHINDT

AINB

DFHINDT

AINC

AINE

DFHINDT, DFHINDAP DFHINDT, DFHINDAP DFHINDT

AINF

DFHINDT

AING AINH

DFHINDT DFHINDT

AINI AINJ

DFHINDT DFHINDT

AINK AINL

DFHINDT DFHINDT

AINM

DFHINDT

AINN AINO

DFHINTRU DFHINTRU

AINP

DFHINTRU

AINQ

DFHINTRU

AINR

DFHINTRU

AINS

DFHINTRU

AIOA

DFJIIOP

AIOB

DFJIIOP

AIOC

DFJIIOP

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

AIND

440

CICS User’s Handbook

Abend codes Abend

Module

Explanation

AIOD

DFJIIOP

AIOE

DFJIIOP

AIOF

DFJIIOP

AIOG

DFJIIOP

AIOH

DFJIIOP

AIOI

DFJIIOP

AIOJ

DFJIIOP

AIOK

DFJIIOP

AIOV

DFJIIOP

AIO0

AISA AISB AISC

DFHIIOP DFHIIOPA DFHIIOP DFHIIOPA DFHIIOP DFHIIOPA DFHIIOP DFHIIOPA DFHIIOP DFHIIOPA DFHMIRS DFHMIRS DFHMIRS

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

AISD AISF AISG AISH AISI

DFHMIRS DFHMIRS DFHMIRS DFHCRNP DFHISP

AISJ AISK AISL

DFHCRNP DFHISP DFHLUP, DFHCLS3, DFHCLS4, DFHZLS1 DFHCRNP DFHCRNP DFHMIRS

AIO1 AIO2 AIO3 AIO4

AISN AISO AISP

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

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

Module

Explanation

AISQ

DFHMIRS

AISR AISS AIST

DFHCRR DFHZARM DFHCRNP

AISU AISV

DFHMIRS DFHMIRS

AISW AISX

DFHCRSP DFHCRSP

AISY AISZ

DFHLUP DFHMXP

AIS1

DFHCRSP

AIS2

DFHCRNP

AIS3 AIS4

DFHCRNP DFHCRNP

AIS5

DFHCRNP

AIS6

DFHMIRS

AIS7 AIS8 AIS9

DFHMIRS DFHMIRS DFHMIRS

AITA AITB AITC AITD

DFHCRNP DFHISP DFHMIRS DFHMIRS

AITE

DFHMIRS

AITF AITG

DFHMIRS DFHMIRS

AJA0

DFJCICS

AJCD AJCE

DFHJCP DFHJCP

AJCS AJCT

DFHJCP DFHJCP

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

442

CICS User’s Handbook

Abend codes Abend

Module

Explanation

AJCU

DFHJCP

AJ01

DFJCICS

AJ02

DFJCICS

AJ03 AJ04 AJ05 AJ07 AJ09 AJ99

DFJCICS DFJCICS DFJCICS DFJCICS DFJCICS DFJCICS

AJMA AJMB

DFHCJVM DFHAPLJ

AJM1 AJM2 AJM3

DFHCJVM DFHCJVM DFHCJVM

AJM4

DFHCJVM

AJM5 AJM6

DFHCJVM DFHCJVM

AJM7

DFHCJVM

AJM8

DFHAPLJ

AJM9

DFHCJVM

AKCB AKCC AKCE AKCF AKCR

DFHKCRP DFHXMAT, DFHXMCL DFHKCQ DFHKCQ DFHXCP

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

AKCS AKCT AKCV

DFHXCP DFHXCP DFHALP

AKC0 AKC1 AKC2

DFHAPATT DFHXCP DFHXCP

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

Chapter 13. Transaction abend codes

443

Abend codes Abend

Module

Explanation

AKC3

Task has been purged

AKC6

DFHXCP, DFHXMAT, DFHXMCL, DFHXMIQ, DFHXMTA DFHXCP

AKC8

DFHXCP

AKC9 AKEA AKEB AKEC AKED AKEF AKEG AKEH

DFHXCP DFHKESTX DFHKESTX DFHKESTX, DFHKERRU DFHKEEDA DFHKERKE DFHKESGM DFHKESTX

AKEI

DFHKESTX

AKEZ AKSE ALGA

DFHKETA DFH99KC DFHLGGL, DFHLGJN, DFHLGLD, DFHLGST DFHLGGL, DFHLGJN, DFHLGLD, DFHLGST DFHLGGL, DFHLGJN, DFHLGLD, DFHLGST DFHLGCM, DFHLGGL, DFHLGJN, DFHLGLD, DFHLGST DFHLGJN

ALGB

ALGC

ALGD

ALGE ALGF

ALGG ALIA ALIB

444

DFHLGGL, DFHLGJN, DFHLGST DFHLGQC DFHAPLI DFHAPLI

CICS User’s Handbook

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

Error releasing lock within log manager domain

Disaster response detected processing building block code used by log manager domain

Disaster response detected processing building block storage interface code used by log manager domain

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

Abend codes Abend

Module

Explanation

ALIC ALID ALIE ALIF ALIG

DFHAPLI DFHAPLI DFHAPLI DFHAPLI DFHAPLI

AMI1 AMNA

DFHMIRS DFHCMP

AMNB

DFHCMP

AMNZ AMSA AMSB AMSC

DFHCMP DFHMSP DFHMSP DFHMSP

AMSD ANQA

ANQC ANQD ANQE

DFHMSP DFHNQED, DFHNQIB, DFHNQNQ, DFHNQST DFHNQED, DFHNQIB, DFHNQNQ, DFHNQST DFHNQED DFHNQED DFHNQRN

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

APCF APCG

DFHAPLI DFHxxx

APCH APCI APCJ APCK APCL

DFHAPLI DFHAPLI DFHAPLI DFHAPLI DFHAPLI

APCN

DFHxxx

APCO

DFHAPXM

APCS APCT

DFHAPLI DFHxxx

APCW

DFHAPLI

ANQB

Error occurred releasing lock within enqueue domain

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

Module

Explanation

APCY APCZ

DFHAPLI DFHAPLI

APC0 APC1 APC2 APC3

DFHPCP, DFHMCY DFHAPLI DFHAPLI DFHAPLI

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

APC4

DFHPCPC2

APC5

DFHPCPC2

APC6 APC7

DFHPCPC2 DFHPCPC2

APC8 APC9 APLx

DFHPCPC2 DFHPCPC2

APP1 APP2

DFHP3270 DFHP3270

APP3 APR1 APSJ APST APSU APSV APSW APSX APSY

DFHP3270 DFHPRK DFHPSIP DFHEPS DFHPSPST DFHPSPST DFHPSPST DFHPSPST DFHPSPST

APSZ

DFHPSPST

APTI

DFHPSPST

APTJ APUA

DFHPSPST DFHPUP

APUB

DFHPUP

APUC

DFHPUP

APUD

DFHPUP

APUE

DFHPUP

446

CICS User’s Handbook

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)

Abend codes Abend

Module

Explanation

APUF APUG APUH APUI APUJ APUK APUL APUM APUN APUO APUP APUQ APUR APUS APUT APUZ APXA ARCB ARHA

DFHPUP DFHPUP DFHPUP DFHPUP DFHPUP DFHPUP DFHPUP DFHPUP DFHPUP DFHPUP DFHPUP DFHPUP DFHPUP DFHPUP DFHPUP DFHPUP DFHAPXM DFHRCEX DFHCPIR

ARHB

DFHCPIR

ARHC

DFHCPIR

ARM0 ARPA

DFHRMXN3 DFHRTC

ARPF ARPG ARPH ARPI ARPJ ARPK ARPL ARPM ARPN

DFHRPAS DFHRPAS DFHRPAS DFHRPAS DFHRPAS DFHRPAS DFHRPAS DFHRPAS DFHRPAS

ARPO ARPU

DFHRPAS DFHRPC01

ARPV

DFHRPC0E

ARPW

DFHRPC0E

ARPX

DFHRPC01

ARPZ

DFHRPC0B

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

Module

Explanation

ARP2

DFHRPMS

ARP4

DFHRPMS

ARP5

DFHRPMS

ARP9

DFHRPC01

ARTA ARTB ARTC ARTD ARTE ARTF ARTG ARTH

DFHRTE DFHRTE DFHRTE DFHRTE DFHRTE DFHRTE DFHRTE DFHRTE

ARUA

DFHXMRU

ARUB

DFHXMXM

ARUC

DFHXMRU

ARXA

DFHRXUW

ARXB

DFHRXUW

ARXC ASCA

DFHRXUW DFHSMSCP

ASCB

DFHSMSCP

ASCP

DFHSMSCP

ASCR ASDA

DFHSMSCP DFHCESD

ASFA ASFB

DFHSFP DFHSFP

ASFC

DFHSFP

ASHA

DFHSHDM

ASHB

DFHSHDM

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

448

CICS User’s Handbook

Abend codes Abend

Module

Explanation

ASHR

DFHSHRSP

ASHU ASH2 ASH3

DFHSHRSP DFHSHXM DFHSHRM

ASH4

DFHSHXM

ASIA ASIB

DFHSII1 DFHSIPLT

ASNA ASNB

DFHSNP DFHSNP

ASNC ASND

DFHSNP DFHSNTU

ASOA

DFHSOL

ASPA

DFHAPAC

ASPB ASPC ASPF ASPI

DFHAPAC DFHSPP DFHAPAC DFHCR2U

ASPJ

DFHCR2U

ASPN

DFHAPAC

ASPO ASPP ASPQ ASPR ASP1 ASP2

DFHAPAC DFHAPAC DFHAPAC DFHAPAC DFHAPAC DFHAPAC

ASP3 ASP7

DFHAPAC DFHAPAC

ASP8 ASP9 ASQA

DFHAPAC DFHEISP DFHCRRSY

ASQB ASQC

DFHCRRSY DFHCRRSY

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

Module

Explanation

ASQD

DFHCRRSY

ASQG

DFHCRRSY

ASQH

DFHCRRSY

ASQI

DFHCRRSY

ASQK ASQL

DFHCRRSY DFHCRRSY

ASQM ASRA ASRB ASRD ASRE

DFHCRRSY DFHSRP DFHSRP DFHSRP DFHSRP

ASRK

DFHSR1

ATCA ATCB

DFHZARQ DFHZARQ

ATCC

DFHZARQ

ATCD ATCE ATCF ATCG

DFHZDSP, DFHZERH DFHZARQ DFHZCRQ DFHZARQ

ATCH

DFHxxx

ATCI

DFHZSUP DFHMRXM DFH62XM DFHZATA DFHZATD DFHZATR DFHZARQ DFHETL, DFHTCPCM, DFHZARQ DFHZSUP DFH62XM DFHTFXM DFHZARQ DFHZRAQ

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

ATCJ

ATCK ATCL

ATCN

ATCO ATCQ

450

CICS User’s Handbook

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

Abend codes Abend

Module

Explanation

ATCR ATCS ATCT

DFHZRAR DFHZARQ DFHZSUP DFHMRXM DFH62XM DFHZARQ DFHETL, DFHZARQ, DFHZISP DFHZSUP DFHMRXM DFH62XM DFHxxx

Temporary storage error Send data after request change direction received Build of surrogate TCTTE for remotely-owned terminal failed

ATCU ATCV

ATCW

ATCX ATCY

ATCZ ATC1 ATC2 ATC3

DFHZARQ, DFHZSUP DFHMRXM DFH62XM DFHZSLS DFHTCRP DFHZSLS DFHZARQ

ATC4 ATC5 ATC6 ATC7

DFHTCRP DFHETL DFHETL DFHZSUP

ATC8 ATC9 ATDC

DFHETL DFHZNCE DFHETD

ATDY ATDZ ATFE

DFHTDRP DFHTDRP DFHTOUT1

ATGE

DFHTOUT1

ATMA

DFHTMP

ATMB ATNA

DFHTMP DFHZNAC

ATND

DFHZARQ, DFHZARL, DFHZSUP

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

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

Module

Explanation

ATNI

Task terminated by NEP (VTAM) or TEP (non-VTAM)

ATOA

DFHZARL, DFHZARM, DFHZARQ, DFHZRAQ, DFHZSUP DFHCESC

ATOB

DFHCESC

ATOC ATOD

DFHCESC DFHCESC

ATOE ATOF

DFHCESC DFHCESC

ATOG

DFHCESC

ATOH ATOT ATOU ATOV ATPA

DFHCESC DFHCEGN DFHCEGN DFHCEGN DFHTPR

ATPB ATPC

DFHTPR DFHTPQ

ATPD ATPE

DFHTPQ DFHTPQ, DFHTPR DFHTPQ, DFHTPR DFHTRP DFHTSDQ

ATPF ATRA ATSA ATSB ATSC

ATSD

ATSP ATSQ ATUF AUEL

452

DFHTSDQ DFHEITS, DFHICP, DFHTSP DFHEITS, DFHICP, DFHTSP DFHEITS, DFHTSP DFHEITS DFH99KO DFHUEM, DFHERM

CICS User’s Handbook

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

Unexpected response from DS domain

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

Abend codes Abend

Module

Explanation

AUEP

DFHUEH

AUXA

CAUCAFB1

AUXB

AUYA

CAUCAFF3, CAUCAFF6, CAUCAFB1 CAUCAFB1

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

AUYC

CAUCAFB1

AUYE AUYF

CAUCAFB2, CAUCAFF3 CAUCAFB1

AUYG

CAUCAFB1

AUYH

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

AUYI AUYJ AUZA

AUZB

AUZC AUZD AUZF

AUZH AUZI AUZJ

CAUCAFF3, CAUCAFF6 CAUCAFF3

AUZK

CAUCAFF3

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

Unexpected error when CAFF or CAFB issued a VSAM FC EXEC CICS command

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

Chapter 13. Transaction abend codes

453

Abend codes Abend

Module

Explanation

AUZL

CAUCAFF4

AUZN

CAUCAFF4

AUZO

CAUCAFF6

AUZQ

CAUCAFF3

AUZR

AUZS

CAUCAFF4, CAUCAFF5, CAUCAFB1 CAUCAFF4

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

AUZU

CAUCAFF1

AUZV

CAUCAFF1

AUZY

CAUCAFF3, CAUCAFB2 CAUCAFF3, CAUCAFF6 CAUCAFF3 DFHWBXN DFHWBBLI

AUZZ AUZ1 AWBA AWBB AWBC AWBE

DFHWBENV, DFHWBTL DFHWBBLI

AWBF AWBH AWBI

DFHWBA DFHWBA DFHWBA

AWBJ

DFHWBA

AWBK

DFHWBA

AWBL AWBM

DFHWBA DFHWBA

AWBQ

AWBU

DFHWBA1, DFHWBBLI DFHWBA1, DFHWBBLI DFHWBC01

AWBV

DFHWBC04

AWBR

454

CICS User’s Handbook

attempted to release called CAUTABM to called CAUTABM to CAUCAFP to create or CAFB called

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

Abend codes Abend

Module

Explanation

AWBX

DFHWBC01

AWBZ

DFHWBC0B

AWB2

DFHWBXN

AWB3

DFHWBXN

AWB4 AWB5 AWB7

DFHWBXN DFHWBM DFHWBENV

AWB8 AWB9

DFHWBGB DFHWBC01

AWC1

DFHWBLT

AWC2 AWC3

DFHWBLT DFHWBLT

AWC4

DFHWBLT

AWC5

DFHWBLT

AWC6

DFHWBLT

AWKY

DFHWKP

AXFA AXFB AXFC

DFHXFP DFHXFP DFHXFP

AXFD AXFE AXFF AXFG

DFHXFP DFHXFP DFHXFP DFHXFP

AXFH AXFI AXFJ

DFHXFP DFHXFP DFHXFP

AXFL AXFM AXFO AXFP AXFQ AXFR AXFS

DFHXFP DFHXFP DFHXFP DFHXFP DFHXFP DFHXFP DFHXFP

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

Module

Explanation

AXFT AXFU AXFW AXFX

DFHXFP DFHXFP DFHXFP DFHXFP

AXFY

DFHXFP

AXF0 AXF1

DFHXFP DFHXFP

AXF2 AXF3

DFHXFP DFHXFP

AXF4

DFHXFX

AXF5 AXF8

DFHXFX DFHXFX

AXMA

DFHxxx

AXMB

DFHxxx

AXMC AXMD AXMY AXMZ

DFHXMAT, DFHXMXE DFHXMAB DFHXMAT DFHXMTA

AXSA AXSC

DFHXSMN DFHXSMN

AXSD AXTA AXTB AXTC AXTD AXTE AXTF AXTG AXTH AXTI AXTJ

DFHTCRP DFHXTP DFHXTP DFHXTP DFHXTP DFHXTP DFHXTP DFHXTP DFHXTP DFHXTP DFHXTP

AXTK

DFHXTP

AXTL

DFHXTP

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

456

CICS User’s Handbook

Abend codes Abend

Module

Explanation

AXTM

DFHXTP

AXTN

DFHETL

AXTO AXTP AXTQ AXTR AZAB AZAD AZAE

DFHXTP DFHXTP DFHXTP DFHXTP DFHZARM DFHZCN1 DFHZCN1

AZAF AZAG AZAH

DFHZCN1 DFHZCT1 DFHZCT1

AZAI AZAJ

DFHZCT1 DFHZCN1

AZAK

DFHZCT1

AZCA AZCB

DFHZARM DFHZARM

AZCC AZCD

AZCJ

DFHZARM DFHETL, DFHZARM DFHETL, DFHZARM DFHZARM DFHZARM DFHETL, DFHZARM DFHETL, DFHZARM, DFHZARQ DFHZARM

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

AZCK

DFHZARM

AZCL

DFHZARM

AZCM AZCN

DFHZARM DFHZARM

AZCO

DFHZCGRP

AZCE AZCF AZCG AZCH AZCI

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

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

Module

Explanation

AZCP

Logic error in ZCP

AZCR

DFHZSUP DFH62XM DFHZSUP DFHMRXM DFH62XM DFHZARL

AZCT AZCU AZCV

DFHZARQ DFHZCOVR DFHZCOVR

AZCW AZIA

DFHZCSTP DFHZIS2

AZIB AZIC AZID

DFHZIS2 DFHZIS2 DFHZIS2

AZIE

DFHZARQ

AZIF AZI1 AZI2 AZI3 AZI4 AZI5 AZI6 AZI7

DFHZARQ DFHZARQ DFHZARQ DFHZARQ DFHZARQ DFHZARQ DFHZARQ DFHZIS2

AZI8 AZI9 AZRA AZRB AZRD

DFHZIS1 DFHZIS2 DFHZARRC DFHZARR0 DFHZARR0

AZRE

DFHZARR0

AZRF

DFHZARRF

AZRG

DFHZARR

AZRH AZRI AZRJ AZRK

DFHZARR DFHZARR1 DFHZARR0 DFHZARRF

AZRL

DFHZARRF

458

CICS User’s Handbook

AZCQ

Error on call to RM domain

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

Abend codes Abend

Module

Explanation

AZRM

DFHZARR

AZRN

DFHZARRF

AZRO AZRP AZRQ AZRR AZRS AZRT AZRU AZRV AZRW AZRY AZRZ AZR2 AZR3 AZR4 AZR5 AZR6

DFHZARER DFHZARER DFHZARRA DFHZARRA DFHZARRA DFHZARRA DFHZARRF DFHZARR1 DFHZARRA DFHZARR DFHZARR DFHZARRA DFHZARRA DFHZARER DFHZARR1 DFHZARER

AZS0 AZS1 AZS2

DFHZSTAP DFHZSTAP DFHZSTAP

AZS3 AZS4 AZS5 AZS6 AZTA AZTB AZTC

DFHZSTAP DFHZSTAP DFHZSTAP DFHZSTAP DFHZTSP DFHZTSP DFHZTSP

AZTF

DFHZTSP

AZTG AZTH AZTI AZTL AZTM AZTN AZTO AZTP AZTQ AZTR AZTS AZTT

DFHZTSP DFHZTSP DFHZTSP DFHZTSP DFHZTSP DFHZTSP DFHZTSP DFHZTSP DFHZTSP DFHZTSP DFHZTSP DFHZTSP

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

Module

Explanation

AZTU AZTV AZTW AZTY AZTZ

DFHZTSP DFHZTSP DFHZTSP DFHZTSP DFHZTSP

AZT1

DFHZTSP

AZT3

DFHZTSP

AZT6 AZT7

DFHZTSP DFHZTSP

AZT8

DFHZTSP

AZT9

DFHZTSP

AZVA

DFHZATS

AZVB AZVC AZVD AZVE AZVF

DFHZATS DFHZATS DFHZATS DFHZATS DFHZATS

AZVG AZVH

DFHZATS DFHZATS

AZVI

DFHZATS

AZVJ AZVK

DFHZATS DFHZATS

AZVL

DFHZATS

AZVM AZVN AZVO AZVP AZVQ

DFHZATMF DFHZATMF DFHZATMD DFHZATMD DFHZATS

AZVR

DFHZATS

AZVS AZVU

DFHZATS DFHZATS

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

460

CICS User’s Handbook

Abend codes Abend

Module

Explanation

AZXA

DFHZXCU

AZXB

DFHZXCU

DHxx 0100

0300 0301 0302 0303 0304

DFH***** DFHEAP DFHECP DFHEDP DFHEPP DFHEAP DFHECP DFHEDP DFHEPP DFHPD DFHPDX DFHPD DFHPDX DFHCSDUP DFHCSDUP DFHCSDUP DFHCSDUP DFHCSDUP

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

0305 0307 0308 0309 0321 0322 0323 0325 0326 0327 0328 0330 0331 0332 0401 0402

DFHCSDUP DFHCSDUP DFHCSDUP DFHCSDUP DFHCSDUP DFHCSDUP DFHCSDUP DFHCSDUP DFHCSDUP DFHCSDUP DFHCSDUP DFHCSDUP DFHCSDUP DFHCSDUP DFHXCSTB DFHXCPRH

0403

DFHXCPRH

0404

DFHXCPRH

0405 0406 0407

DFHXCPRH DFHXCPRH DFHXCPRH

0101

0211 0212

Translator program check

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

Module

Explanation

0408

DFHXCPRH

0409

DFHXCPRH

0410

DFHXCPRH

0411 0412

DFHXCDMP DFHXCEIP

0413

DFHXCEIP

0414

DFHXCEIP

0415 0501

0555

DFHXCEIP DFHCALLA, DFHMSGIF, DFHTRCIF DFHAPLJ

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

462

CICS User’s Handbook

CICS JVM interface percolation abend to drive LanguageEnvironment recovery

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

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

Error code

Symbolic label

X'5D' X'FB' X'FC' X'7A' X'79'

TCZPRDTO TCZPSUNB TCZPSOPN TCZPSRAC TCZPSRAF

X'FD' X'71'

TCZPSRC TCZPSLE

X'72' X'FF' X'FE'

TCZPSVF TCZPSPE TCZPSRF

X'6C'

TCZPSAF

X'6D' X'E9' X'DB' X'6F' X'C1'

TCZPSAR TCZSTIND TCZPIPL TCZSDAS TCZSRCAT

X'B1'

TCZRPLAC

X'B4' X'11' X'E6' X'14'

TCZRSNE TCZSRCBF TCZDMLG TCZLRCER

X'18'

TCZLRCNR

X'10' X'19' X'15'

TCZSRCTU TCZSRCTS TCZSRCPF

465

VTAM CICS message

Action flags set

Error code

Symbolic label

DFHZC2408

23 24 23 24 23 24 23 24

9 10 11 18

X'1A'

TCZSRCVE

9 10 11 18

X'1E'

TCZSRCV2

9 10 11 15

X'D0'

TCZTXCS

9 10 11 18

X'D1'

TCZTXCU

X'E0' X'E1' X'E2' X'80' X'13' X'1D' X'20' X'BB'

TCZDMSN TCZDMRA TCZDMCL TCZSRCSP TCZSRCVH TCZSRCVI TCZVTAMI TCZSEXUC

X'82'

TCZSSXUC

X'B5'

TCZSAXUC

X'60' X'90'

TCZUNCMD TCZLGCER

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'

TCZSDSE5 TCZSESE1 TCZSDAUC TCZRACES TCZSRCNA TCZSDSE6 TCZRSTLE TCZSDRE2 TCZSRCTC TCZSSXNR TCZAIER TCZCPYNS TCZRVSZ1 TCZRVSZ3 TCZSDSE4 TCZRVSZ2 TCZACT01 TCZSXC1 TCZSXC2 TCZPXE1 TCZROCT TCZBKTSE TCZSDSE8

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

466

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

CICS User’s Handbook

VTAM CICS message

Action flags set

Error code

Symbolic label

DFHZC2446

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

X'84'

TCZSSXIB

X'9A' X'65'

TCZDOMCF TCZINVRR

X'A7' X'83' X'CC' X'D5' X'D4' X'CD' X'93' X'44'

TCZBOEB TCZSSXAR TCZSRCCI TCZCXE2 TCZCXRR TCZSRCCX TCZRACET TCZSRCDE

X'D8' X'DD' X'99' X'D3' X'88'

TCZRNCH TCZPXE2 TCZSDSE7 TCZDMPD TCZLEXCI

X'89' X'D9' X'F2' X'DA' X'A8'

TCZLEXUS TCZYX43 TCZEXRVT TCZSXC3 TCZFMHLE

X'A9' X'AA' X'E3' X'9B' X'76' X'77' X'40' X'41'

TCZRACRF TCZSDSE9 TCZCNCL TCZRACNL TCZLGNA TCZDMRY TCZINCPY TCZTOLRQ

X'42' X'4B' X'45' X'46' X'85'

TCZUNPRT TCZICPUT TCZCHMX TCZOCIR TCZUNEGR

X'BC' X'E8' X'50' X'51' X'52' X'53' X'5A'

TCZINIIR TCZDMSLE TCZSDRE3 TCZBDPRI TCZBDUAC TCZBDTOS TCZSBIRV

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

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

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

Action flags set

Error code

Symbolic label

DFHZC3422

2 3 9 10 11 18 24 9 10 11 15 24 3 23 23 23 23

X'5B'

TCZNSP01

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'

TCZNSP02 TCZSTRMH TCZSTRMM TCZSTON TCZSTIN TCZSTLER TCZERMGR TCZUNBIS TCZEMWBK TCZVTAMO TCZVTAMK TCZVTAMA TCZTIOAE

X'66' X'5E' X'5F' X'48' X'49' X'4A' X'57' X'9D'

TCZSIGR TCZBRUAC TCZBDSQP TCZOPSIN TCZCLSIN TCZOPACB TCZRELIS TCZRSPER

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'

TCZSEXOS TCZCLRRV TCZVHOLD TCZLUERR TCZXSHRA TCZVRNOP TCZDEVND TCZSLSRL TCZVRDAC TCZNRLUF TCZRCLUF TCZCLEAN TCZUNBFE TCZNOISC TCZDSPCL TCZDMGF TCZPASSD TCZPSPRE TCZLUINP TCZNPSAU TCZXUVAR

X'C8'

TCZLUINH

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

468

2 3 9 10 11 24

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

CICS User’s Handbook

VTAM CICS message

Action flags set

Error code

Symbolic label

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

24 15 24

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'

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

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

Chapter 15. VTAM-associated errors

469

VTAM CICS message DFHZC6590 DFHZC6591 DFHZC6593 DFHZC6594 DFHZC6595 DFHZC6596 DFHZC6598

470

Action flags set 9 10 11 15 24 24 2 3 5 24 2 3 15 24

CICS User’s Handbook

Error code

Symbolic label

X'3F' X'3E' X'3B' X'3A' X'39' X'38' X'56'

TCZXRST TCZXERR TCZXSBC TCZXSHR TCZXSABN TCZXSWAS TCZXRFVS

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

Message

Action flags set

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

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

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

Message

Action flags set

0869 08FF 1000 1001 1002 1003 1005 1008 1009 10FF 2003 20FF 400B 40FF 8000 8005 80FF FFFF

DFHZC3457 DFHZC3447 DFHZC3494 DFHZC2481 DFHZC2481 DFHZC2479 DFHZC3406 DFHZC2478 DFHZC3458 DFHZC3446 DFHZC3405 DFHZC3445 DFHZC2477 DFHZC3453 DFHZC3435 DFHZC3435 DFHZC3435 DFHZC2460

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

Sense code

Action flags set

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

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

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

Sense code

Action flags set

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

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

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

Field

Bit mask

Hex bit setting

Action

1 2 3 4 5 6

TWAOPT1

1... .... .1.. .... ..1. .... ...1 .... .... 1... .... .1..

"X'80'" "X'40'" "X'20'" "X'10'" "X'08'" "X'04'"

1... ....

"X'80'"

.1.. .... ..1. ....

"X'40'" "X'20'"

12

...1 ....

"X'10'"

13

.... 1...

"X'08'"

14

.... .1..

"X'04'"

.... ..1. 1... .... .1.. ....

"X'02'" "X'80'" "X'40'"

20

...1 ....

"X'10'"

21

.... 1...

"X'08'"

22 23 24

.... .1.. .... ..1. .... ...1

"X'04'" "X'02'" "X'01'"

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

9 10 11

15 17 18

474

TWAOPT2

TWAOPT3

CICS User’s Handbook

VTAM identifiers

Chapter 17. VTAM submodule identifiers This chapter contains Product-sensitive Programming Interface information. Hex ID

Module

Description

X'00' X'01' X'02' X'03' X'04' X'06' X'08' X'09' X'0A'

ZDSP ZARQ ZLOC ZDET ZTCP ZCRQ ZSTU ZTSP ZHPX

X'0B' X'0C' X'0D' X'0E'

ZISP ZIS1 ZIS2 ZABD

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'

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

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

Module

Description

X'2C' X'2E' X'2F' X'30' X'31' X'32' X'33' X'34'

ZRAR ZRRX ZNSP ZRSY ZSAX ZSCX ZSDA ZSKR

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'

ZSES ZSEX ZSIM ZSIX ZSLS ZSSX ZSYX ZTAX ZTPX ZOPA ZSHU ZQUE ZEMW

X'42' X'43' X'44'

ZSYN ZTRA ZAND

X'45' X'46' X'47'

ZCNA ZCNR ZCNC

X'48' X'49' X'4A' X'4B' X'4C' X'4D' X'4E' X'4F' X'50' X'52'

ZUAX ZUOX ZARL ZARM ZRVL ZRLX ZSDL ZSLX ZERH ZBKT

X'53'

ZCNT

X'54' X'55' X'56'

ZCHS ZCHR ZUSR

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

Module

Description

X'57'

ZDST

X'58'

ZEV1

X'59'

ZEV2

X'5E'

ZXRC

X'5F' X'60'

ZXTS ZXRL

X'61' X'62'

ZINT ZXRT

X'63' X'64'

ZSTA ZRLP

X'65' X'66'

ZCRT ZRAS

X'67' X'7D' X'7E' X'7F' X'80' X'82' X'84' X'86'

ZXPS ZRLG ZNAC ZRSP ZATR ZATA ZATD ZGMM

X'8B' X'C0'

ZATS ZQ00

X'C1' X'C2' X'C3' X'C4' X'C5' X'C6' X'C7' X'C8' X'C9' X'C4'

ZQIN ZQBA ZQCH ZQDL ZQIT ZQRC ZQRS ZQIQ ZQIS ZTCT

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

Class

SAA

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'

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

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: [email protected] 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