CICS User`s Handbook

Transcription

CICS User`s Handbook
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