Вы находитесь на странице: 1из 491

CICS Transaction Server for z/OS

CICS Users Handbook


V ersion 2 Release 2

SC34-5986-06

CICS Transaction Server for z/OS

CICS Users Handbook


V ersion 2 Release 2

SC34-5986-06

Note! Before using this information and the product it supports, be sure to read the general information under Notices on page 473.

edition () This edition applies to Version 2 Release 2 of CICS Transaction Server for z/OS, program number 5697-E93, 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. 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 wish to send comments by mail, please address them to: User Technologies Department Mail Point 095 IBM United Kingdom Laboratories Hursley Park WINCHESTER Hampshire SO21 2JN United Kingdom 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, 2002. All rights reserved. US Government Users Restricted Rights Use, duplication or disclosure restricted by GSA ADP Schedule Contract with IBM Corp.

Contents
Preface . . . . . . . . What this handbook is about Who this handbook is for . What you need to know to Handbook structure . . . . . . . . . . . . . . . . . . . . . . understand this . . . . . . . . . . . . . . . . . . handbook . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . v v v v v ix ix ix ix 1 1 1 1 1 2

Summary of changes . . . . . . . Changes for CICS Transaction Server for Changes for CICS Transaction Server for Changes made for CICS/ESA 4.1 edition

. . . . . . . . . . z/OS, Version 2 Release 2 z/OS Version 2 Release 1 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .

Chapter 1. Command-level application programming General format . . . . . . . . . . . . . . . DL/I command format . . . . . . . . . . . . RPG II command format . . . . . . . . . . . Restrictions for distributed program link (DPL) . . . . API command syntax . . . . . . . . . . . . .

Chapter 2. SPI command syntax . . . . . . . . . . . . . . . . . . 85 Chapter 3. CICS-Supplied Transaction . . . . . . . . . . . . . . . 173 Chapter 4. Resource definition online . . . . . . . . . . . . . . . 217 Chapter 5. DFHCSDUP commands . . . . . . . . . . . . . . . . 229 Chapter 6. Front End Programming FEPI application programming . . . Previously allocated conversation Temporary conversation . . . . Previously allocated conversation Temporary conversation . . . . FEPI system programming . . . . Interface . . . . . . . . . . . . . . . . . . . . . . . . command . . . . . . . . . . . . . . . . . . . . . . . . reference . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 235 235 235 236 237 238 243 251 251 264 278 281 281 282 290 295

Chapter 7. CICS-value data areas used by all commands . . . . CVDAs and numeric values in alphabetic sequence . . . . . . . . CVDAs and numeric values in numeric sequence . . . . . . . . . CVDAs returned by the INQ NETNAME|TERMINAL DEVICE command Chapter 8. EXEC interface block EIB field names and descriptions . EIBFN codes . . . . . . . . EIBRCODE values . . . . . . RESP values and conditions . . (EIB) . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .

Chapter 9. RESP2 values and their meanings . . . . . . . . . . . . 299 Chapter 10. EXEC interface block (EIB) response and function codes Response codes of EXEC CICS commands . . . . . . . . . . . . EXEC CICS DISCARD, INQUIRE, PERFORM, and SET commands . . EXEC CICS DISABLE, ENABLE, and EXTRACT EXIT commands . . Function codes of EXEC CICS commands . . . . . . . . . . . . 395 395 395 396 396

. . . .

. . . .

Copyright IBM Corp. 1989, 2002

iii

Chapter 11. DFH messages . . Message Identifiers . . . . . . DFHnnnn identifiers. . . . . DFHccnnnn identifiers . . . . Action codes . . . . . . . Severity codes . . . . . . Format of information . . . . . XMEOUT parameters . . . . Route codes . . . . . . . Message editing . . . . . . Console message reformatting Terminal identifiers . . . . . Abend code inserts . . . . . Dumps . . . . . . . . . Terminology . . . . . . . MVS user abend codes . . . . Ordered by abend code . . . Ordered by message identifier .

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

405 405 405 405 408 408 409 410 410 410 410 411 411 412 412 412 412 413

Chapter 12. Transaction abend codes . . . . . . . . . . . . . . . 415 Format of information . . . . . . . . . . . . . . . . . . . . . . 416 Chapter 13. Transaction abend codes . . . . . . . . . . . . . . . 417 Chapter 14. 1xxx-9xxx (VS COBOL II) abend codes . . . . . . . . . . 447 Chapter 15. VTAM-associated errors . . . . . . . . . . . . . . . . 449 VTAM terminal error codes and CICS message numbers . . . . . . . . . 449 Chapter 16. System sense codes received . . . . . . . . . . . . . 455 Action flag settings and default actions . . . . . . . . . . . . . . . 457 Chapter 17. VTAM submodule identifiers . . . . . . . . . . . . . . 459 Chapter 18. AP domain storage classes . . . . . . . . . . . . . . 463 Bibliography . . . . . . . . . . . . . . . . CICS Transaction Server for z/OS . . . . . . . . CICS books for CICS Transaction Server for z/OS . CICSPlex SM books for CICS Transaction Server for Other CICS books . . . . . . . . . . . . . Books from related libraries . . . . . . . . . . . Other publications . . . . . . . . . . . . . Determining if a publication is current . . . . . . . . . . . . . z/OS . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 465 465 465 466 466 466 467 467

Accessibility . . . . . . . . . . . . . . . . . . . . . . . . . 469 Index . . . . . . . . . . . . . . . . . . . . . . . . . . . . 471 Notices . . . . . . . . . . . . . . . . . . . . . . . . . . . 473 Programming interface information . . . . . . . . . . . . . . . . . 474 Trademarks. . . . . . . . . . . . . . . . . . . . . . . . . . 474 Sending your comments to IBM . . . . . . . . . . . . . . . . . 477

iv

CICS TS for z/OS: CICS Users 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: v System programmers v CICS or system operators v 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.

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 z/OS. For programming information, see the CICS Application Programming Reference. Chapter 2, SPI command syntax, on page 85 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 173 Gives a summary of the CICS-supplied transactions. For more detailed information, see CICS Supplied TransactionsCICS Supplied Transactions. Chapter 4, Resource definition online, on page 217 Gives a summary of the syntax for resource definition online. For more detailed information, see the CICS Resource Definition Guide. Chapter 5, DFHCSDUP commands, on page 229 Gives a summary of the syntax of DFHCSDUP commands. For more detailed information, see the CICS Operations and Utilities Guide. Chapter 6, Front End Programming Interface command reference, on page 235 Gives a summary of the syntax for front end programming interface command references. For more detailed information, see the CICS Front End Programming Interface Users Guide.

Copyright IBM Corp. 1989, 2002

Chapter 7, CICS-value data areas used by all commands, on page 251 Gives a table of CVDA values. For programming information, see the CICS System Programming Reference manual. Chapter 8, EXEC interface block (EIB), on page 281 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 9, RESP2 values and their meanings, on page 299 Lists the RESP2 values returned by CICS commands and gives their meanings. For programming information, see the CICS System Programming Reference and the CICS Problem Determination Guide. Chapter 10, EXEC interface block (EIB) response and function codes, on page 395 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 405 Gives a summary of the terminal error messages and codes. For more detailed information, see CICS Messages and Codes. Chapter 12, Transaction abend codes, on page 415 Gives a description of CICS transaction abend codes. For more detailed information, see CICS Messages and Codes. Chapter 13, Transaction abend codes, on page 417 Gives a list of CICS transaction abend codes with a summary of their meanings. For more detailed information, see CICS Messages and Codes. Chapter 14, 1xxx-9xxx (VS COBOL II) abend codes, on page 447 Gives some information about COBOL II abend codes. For more detailed information, see the VS COBOL II Application Program Debugging Guide. Chapter 15, VTAM-associated errors, on page 449 Gives a summary of VTAM errors and associated CICS messages. For more detailed information, see CICS Messages and Codes. Chapter 16, System sense codes received, on page 455 Gives information about the action taken by CICS on receiving the VTAM sense codes listed.

vi

CICS TS for z/OS: CICS Users Handbook

Chapter 17, VTAM submodule identifiers, on page 459 Gives information about the product-sensitive product interface. Chapter 18, AP domain storage classes, on page 463 Shows the valid AP domain storage classes.

Preface

vii

viii

CICS TS for z/OS: CICS Users Handbook

Summary of changes
Changes for CICS Transaction Server for z/OS, Version 2 Release 2
This book is based on the CICS Transaction Server for z/OS Version 2 Release 1 version. It includes changes and additions to the existing sections which have been introduced to support CICS Transaction Server for z/OS, Version 2 Release 2.

Changes for CICS Transaction Server for z/OS Version 2 Release 1


This handbook includes information about the new or enhanced facilities introduced by CICS Transaction Server for z/OS Version 2 Release 1 . 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 CVDAs and numeric values in alphabetic sequence on page 251, 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, 2002

ix

CICS TS for z/OS: CICS Users Handbook

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

Restrictions for distributed program link (DPL)


The following commands are not supported in a program running in a resource region in response to a distributed program link command:
Table 1. Restricted API commands ADDRESS .... ALLOCATE ASSIGN .... CONNECT PROCESS CONVERSE EXTRACT PROCESS FREE CONVID HANDLE AID ISSUE .... PURGE MESSAGE RECEIVE .... ROUTE SEND .... SIGNOFF SIGNON WAIT TERMINAL

Copyright IBM Corp. 1989, 2002

API syntax

API command syntax


ABEND
ABEND ABCODE(name) CANCEL NODUMP

This command is threadsafe.

ADDRESS
ADDRESS ACEE(ptr-ref) COMMAREA(ptr-ref) CWA(ptr-ref) EIB(ptr-ref)

TCTUA(ptr-ref)

TWA(ptr-ref)

This command is threadsafe.

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

ALLOCATE (APPC)
ALLOCATE SYSID(systemname) PROFILE(name) PARTNER(name) NOQUEUE STATE(cvda)

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

ALLOCATE (LUTYPE6.1)
ALLOCATE SESSION(name) SYSID(systemname)

PROFILE(name)

NOQUEUE

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

CICS TS for z/OS: CICS Users Handbook

API syntax

# # # # # #

ALLOCATE (MRO)
ALLOCATE SYSID(systemname) PROFILE(name) NOQUEUE STATE(cvda)

Conditions: INVREQ, SYSBUSY, SYSIDERR

ASKTIME
ASKTIME ABSTIME(data-area)

Chapter 1. Command-level application programming

API syntax

ASSIGN

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

Condition: INVREQ

This command is threadsafe.

CICS TS for z/OS: CICS Users Handbook

API syntax

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

Condition: LENGERR

BUILD ATTACH (LUTYPE6.1)


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

RRESOURCE(name)

QUEUE(name)

IUTYPE(data-value)

DATASTR(data-value)

RECFM(data-value)

BUILD ATTACH (MRO)


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

RRESOURCE(name)

QUEUE(name)

IUTYPE(data-value)

DATASTR(data-value)

RECFM(data-value)

CANCEL
CANCEL REQID(name) SYSID(systemname) TRANSID(name)

Conditions: ISCINVREQ, NOTAUTH, NOTFND, SYSIDERR

Chapter 1. Command-level application programming

API syntax

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

ESMREASON(data-area)

ESMRESP(data-area)

Conditions: INVREQ, NOTAUTH, USERIDERR

CHANGE TASK
CHANGE TASK PRIORITY(data-value)

Condition: INVREQ

CONNECT PROCESS (APPC)


CONNECT PROCESS CONVID(name) SESSION(name) PROCNAME(data-area) PROCLENGTH(data-value) PARTNER(name) SYNCLEVEL(data-value) PIPLIST(data-area) PIPLENGTH(data-value) STATE(cvda)

Conditions: INVREQ, LENGERR, NOTALLOC, PARTNERIDERR, TERMERR

CONVERSE (APPC)
CONVERSE CONVID(name) TOLENGTH(data-area) TOFLENGTH(data-area) FROM(data-area) FROMLENGTH(data-value) FROMFLENGTH(data-value) INTO(data-area) SET(ptr-ref)

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

NOTRUNCATE

STATE (cvda)

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

CICS TS for z/OS: CICS Users Handbook

API syntax

CONVERSE (default)
CONVERSE FROM(data-area) FROMLENGTH(data-value) FROMFLENGTH(data-value) INTO(data-area) SET(ptr-ref)

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

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

NOTRUNCATE

DEST(name)

Conditions: LENGERR

CONVERSE (LUTYPE2/LUTYPE3)
CONVERSE FROM(data-area) FROMLENGTH(data-value) FROMFLENGTH(data-value) INTO(data-area) SET(ptr-ref) TOLENGTH(data-area) TOFLENGTH(data-area)

ERASE DEFAULT ALTERNATE STRFIELD

CTLCHAR(data-value)

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

DEFRESP

NOTRUNCATE

ASIS

Conditions: EOC, LENGERR, TERMERR

CONVERSE (LUTYPE4)
CONVERSE FROM(data-area) FROMLENGTH(data-value) FROMFLENGTH(data-value) INTO(data-area) SET(ptr-ref)

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

DEFRESP

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

FMH

NOTRUNCATE

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

Chapter 1. Command-level application programming

API syntax

CONVERSE (LUTYPE6.1)
CONVERSE FROM(data-area) FROMLENGTH(data-value) FROMFLENGTH(data-value) FMH CONVID(name) SESSION(name)

ATTACHID(name)

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

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

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

NOTRUNCATE

DEFRESP

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

CONVERSE (MRO)
CONVERSE CONVID(name) SESSION(name) ATTACHID(name)

FROM(data-area)

FROMLENGTH(data-value) FROMFLENGTH(data-value)

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

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

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

NOTRUNCATE

DEFRESP

STATE (cvda)

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

CONVERSE (SCS)
CONVERSE FROM(data-area) FROMLENGTH(data-value) FROMFLENGTH(data-value) INTO(data-area) SET(ptr-ref)

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

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

DEFRESP

STRFIELD

NOTRUNCATE

Conditions: LENGERR, TERMERR

CICS TS for z/OS: CICS Users Handbook

API syntax

CONVERSE (System/3)
CONVERSE FROM(data-area) FROMLENGTH(data-value) FROMFLENGTH(data-value) INTO(data-area) SET(ptr-ref)

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

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

NOTRUNCATE

DEST(name)

ASIS

Conditions: LENGERR

CONVERSE (System/7)
CONVERSE FROM(data-area) FROMLENGTH(data-value) FROMFLENGTH(data-value) INTO(data-area) SET(ptr-ref)

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

DEST(name)

ASIS

PSEUDOBIN

Condition: LENGERR

CONVERSE (2260)
CONVERSE FROM(data-area) FROMLENGTH(data-value) FROMFLENGTH(data-value) INTO(data-area) SET(ptr-ref)

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

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

NOTRUNCATE

CTLCHAR(data-value)

LINEADDR(data-value)

DEST(name)

LEAVEKB

Condition: LENGERR

Chapter 1. Command-level application programming

API syntax

CONVERSE (2741)
CONVERSE FROM(data-area) FROMLENGTH(data-value) FROMFLENGTH(data-value) INTO(data-area) SET(ptr-ref)

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

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

NOTRUNCATE

DEST(name)

Conditions: LENGERR, RDATT, WRBRK

CONVERSE (3270 display)


CONVERSE FROM(data-area) FROMLENGTH(data-value) FROMFLENGTH(data-value) INTO(data-area) SET(ptr-ref)

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

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

NOTRUNCATE

ERASE DEFAULT ALTERNATE STRFIELD

CTLCHAR(data-value)

DEST(name)

ASIS

Condition: LENGERR

CONVERSE (3270 logical)


CONVERSE FROM(data-area) FROMLENGTH(data-value) FROMFLENGTH(data-value) INTO(data-area) SET(ptr-ref) TOLENGTH(data-area) TOFLENGTH(data-area)

ERASE DEFAULT ALTERNATE STRFIELD

CTLCHAR(data-value)

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

DEFRESP

NOTRUNCATE

ASIS

Conditions: INVREQ, LENGERR, TERMERR

10

CICS TS for z/OS: CICS Users Handbook

API syntax

CONVERSE (3600 BTAM)


CONVERSE FROM(data-area) FROMLENGTH(data-value) FROMFLENGTH(data-value) INTO(data-area) SET(ptr-ref)

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

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

NOTRUNCATE

ASIS

Condition: LENGERR

CONVERSE (3600-3601)
CONVERSE FROM(data-area) FROMLENGTH(data-value) FROMFLENGTH(data-value) INTO(data-area) SET(ptr-ref)

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

LDC(name) FMH

DEFRESP

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

NOTRUNCATE

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

CONVERSE (3600-3614)
CONVERSE FROM(data-area) FROMLENGTH(data-value) FROMFLENGTH(data-value) INTO(data-area) SET(ptr-ref)

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

DEFRESP

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

NOTRUNCATE

Conditions: LENGERR, TERMERR

Chapter 1. Command-level application programming

11

API syntax

CONVERSE (3650 interpreter)


CONVERSE FROM(data-area) FROMLENGTH(data-value) FROMFLENGTH(data-value) INTO(data-area) SET(ptr-ref)

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

DEFRESP

FMH

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

NOTRUNCATE

Conditions: EOC, EODS, INBFMH, LENGERR, TERMERR

CONVERSE (3650-3270)
CONVERSE FROM(data-area) FROMLENGTH(data-value) FROMFLENGTH(data-value) INTO(data-area) SET(ptr-ref)

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

CTLCHAR(data-value)

ERASE DEFAULT ALTERNATE

DEFRESP

FMH

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

NOTRUNCATE

Conditions: LENGERR, TERMERR

CONVERSE (3650-3653)
CONVERSE FROM(data-area) FROMLENGTH(data-value) FROMFLENGTH(data-value) INTO(data-area) SET(ptr-ref)

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

DEFRESP

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

NOTRUNCATE

Conditions: EOC, LENGERR, TERMERR

12

CICS TS for z/OS: CICS Users Handbook

API syntax

CONVERSE (3650-3680)
CONVERSE FROM(data-area) FROMLENGTH(data-value) FROMFLENGTH(data-value) INTO(data-area) SET(ptr-ref)

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

FMH

DEFRESP

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

NOTRUNCATE

Conditions: LENGERR, TERMERR

CONVERSE (3735)
CONVERSE FROM(data-area) FROMLENGTH(data-value) FROMFLENGTH(data-value) INTO(data-area) SET(ptr-ref)

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

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

NOTRUNCATE

ASIS

Conditions: EOF, LENGERR

CONVERSE (3740)
CONVERSE FROM(data-area) FROMLENGTH(data-value) FROMFLENGTH(data-value) INTO(data-area) SET(ptr-ref)

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

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

NOTRUNCATE

ASIS

Condition: LENGERR

CONVERSE (3767)
CONVERSE FROM(data-area) FROMLENGTH(data-value) FROMFLENGTH(data-value) INTO(data-area) SET(ptr-ref)

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

DEFRESP

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

NOTRUNCATE

Conditions: EOC, LENGERR, SIGNAL, TERMERR

Chapter 1. Command-level application programming

13

API syntax

CONVERSE (3770)
CONVERSE FROM(data-area) FROMLENGTH(data-value) FROMFLENGTH(data-value) INTO(data-area) SET(ptr-ref)

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

DEFRESP

FMH

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

NOTRUNCATE

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

CONVERSE (3790 full-function or inquiry)


CONVERSE FROM(data-area) FROMLENGTH(data-value) FROMFLENGTH(data-value) INTO(data-area) SET(ptr-ref)

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

FMH

DEFRESP

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

NOTRUNCATE

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

CONVERSE (3790 3270-display)


CONVERSE FROM(data-area) FROMLENGTH(data-value) FROMFLENGTH(data-value) INTO(data-area) SET(ptr-ref)

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

DEFRESP

CTLCHAR(data-value)

ERASE DEFAULT ALTERNATE MAXLENGTH(data-value) MAXFLENGTH(data-value) NOTRUNCATE

Conditions: LENGERR, TERMERR

14

CICS TS for z/OS: CICS Users Handbook

API syntax

DEFINE COUNTER
DEFINE COUNTER(name) POOL(name) VALUE(data-value) MINIMUM(data-value)

MAXIMUM(data-value)

Conditions: INVREQ

DELAY
INTERVAL(0) DELAY INTERVAL(hhmmss) TIME(hhmmss) REQID(name)

FOR

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

UNTIL

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

Conditions: EXPIRED, INVREQ

DELETE COUNTER
DELETE COUNTER(name) POOL(name)

Conditions: INVREQ

Chapter 1. Command-level application programming

15

API syntax

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

SYSID(systemname)

NOSUSPEND

RBA RRN

keylength:
KEYLENGTH(data-value) GENERIC NUMREC(data-value)

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

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

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

DELETEQ TS
DELETEQ TS QUEUE(name) QNAME(name)

SYSID(systemname)

Conditions: INVREQ, ISCINVREQ, LOCKED, NOTAUTH, QIDERR, SYSIDERR This command is threadsafe.

16

CICS TS for z/OS: CICS Users Handbook

API syntax

DEQ
UOW DEQ RESOURCE(data-area) LENGTH(data-value) MAXLIFETIME(cvda) TASK

Conditions: INVREQ, LENGERR # This command is threadsafe if it is defined as LOCAL. It is non-threadsafe if it is defined as GLOBAL.

Chapter 1. Command-level application programming

17

API syntax

DFHMDF
DFHMDF fld

DFHMDF (1 of 2)
,

POS=

number (line,column) LENGTH=number JUSTIFY=( LEFT , RIGHT INITIAL=char-data XINIT=hex-data

) BLANK ZERO

(1) GINIT=DBCS-characters ATTRB=( att1 att2 ) DEFAULT COLOR= color BASE PS= psid

att1:
ASKIP PROT UNPROT ,NUM

att2:

BRT NORM DRK

,DET ,IC ,FSET

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

18

CICS TS for z/OS: CICS Users Handbook

API syntax

DFHMDF (2 of 2)
,

, VALIDN=( MUSTFILL MUSTENTER TRIGGER GRPNAME=group-name OCCURS=number PICIN=value PICOUT=value OUTLINE= BOX , ( LEFT RIGHT OVER UNDER NO SOSI= YES YES TRANSP= NO CASE=MIXED ) )

Chapter 1. Command-level application programming

19

API syntax

DFHMDI Minimum BMS


, map DFHMDI SIZE=(line,column) TERM=type , CTRL=( PRINT length FREEKB ALARM FRSET NO EXTATT= MAPONLY YES DEFAULT COLOR= color NO CURSLOC= YES OFF HILIGHT= BLINK REVERSE UNDERLINE NO SOSI= YES YES TRANSP= NO JUSTIFY=BOTTOM DSATTS=(attr) OUTLINE= BOX , ( LEFT RIGHT OVER UNDER ) ) PS= BASE psid , ,

VALIDN= MUSTFILL MUSTENTER TRIGGER COLUMN=number LINE=number FIELDS=NO , MAPATTS=(attr) ,

20

CICS TS for z/OS: CICS Users Handbook

API syntax

DFHMDI Standard BMS


,

PARTN=(name) , ACTIVATE OBFMT= YES NO FIELD

DATA= BLOCK NO TIOAPFX= YES FLDSEP= char Xhex-char

DFHMDI Full BMS


,

SAME COLUMN= number NEXT NEXT LINE= number SAME JUSTIFY=( jst HEADER=YES TRAILER=YES

jst:
LEFT RIGHT , FIRST LAST

Chapter 1. Command-level application programming

21

API syntax

DFHMDX #
DFHMDX MAPSET=name MAPSET=* ,DOCTYPE= ,MODULE=name ,MAP=* ,TITLE=title-text ,MAP= * name

-//W3C//DTD HTML 3.2//EN doctype

,MASTHEAD=

url url,alternate text

,BACKGROUND=url

,BGCOLOR=

color

,TEXT=

color

,LINK=

color

,VLINK=

color

,ALINK=

color

, , key = button ,

, ,RESET= bmscolor = color

YES NO text

, ,RALIGN=( (row,col) ) ,SUPPRESS=(

, (row,col) ,HEAD ,FOOT )

,ONLOAD=text

,ONUNLOAD=text ,PROPFONT=

YES NO

,OPENSQ=

char hex-value

,CLOSESQ=

char hex-value

,OPENBR=

char hex-value

,CLOSEBR=

char hex-value

#
,EXCLAM= char hex-value ,CODEPAGE=codepage ,NUMALIGN= NO YES

22

CICS TS for z/OS: CICS Users Handbook

API syntax

DFHMSD Minimum BMS


mapset DFHMSD TYPE= DSECT MAP FINAL

OUT MODE= IN INOUT LOWER FOLD= UPPER NO TRIGRAPH= YES ASM LANG= COBOL COBOL2 PLI C STORAGE=AUTO BASE=name , CTRL=( PRINT length FREEKB ALARM FRSET NO EXTATT= MAPONLY YES DEFAULT COLOR= color ADS DSECT= ADSL SOSI= NO ) CURSLOC=

NO YES OFF HILIGHT= BLINK REVERSE UNDERLINE PS= BASE psid ,

VALIDN= MUSTFILL MUSTENTER TRIGGER USEREXIT TERM=type SUFFIX=n NO TIOAPFX= YES , MAPATTS=(attr) , DSATTS=(attr) OUTLINE= BOX , ( LEFT RIGHT OVER UNDER )

YES YES TRANSP= NO

Chapter 1. Command-level application programming

23

API syntax

DFHMSD Standard BMS


,

PARTN=(name) , ACTIVATE LDC=mnemonic NO OBFMT= YES , HTAB= tab , tab FIELD BLOCK char Xhex-char

VTAB= DATA= FLDSEP=

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

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

DFHPSD
, partnset DFHPSD SUFFIX=user-suffix ALTSCRN=(lines,columns) CHARSZE=(vpels,hpels)

24

CICS TS for z/OS: CICS Users Handbook

API syntax

DOCUMENT CREATE
DOCUMENT CREATE DOCTOKEN(data-area) FROM(data-area) TEXT(data-area) BINARY(data-area) FROMDOC(data-area) TEMPLATE(name) SYMBOLLIST(data-area) LISTLENGTH(data-value) DELIMITER(data-value) DOCSIZE(data-area) HOSTCODEPAGE(name) UNESCAPED LENGTH(data-area)

Conditions: INVREQ, NOTFND, SYMBOLERR, TEMPLATERR

DOCUMENT INSERT
DOCUMENT INSERT DOCTOKEN(data-area) TEXT(data-area) BINARY(data-area) FROM(data-area) SYMBOL(name) TEMPLATE(name) FROMDOC(data-area) BOOKMARK(name) LENGTH(data-value)

DOCSIZE(data-value)

HOSTCODEPAGE(name)

AT(name) TO(name)

Conditions: DUPREC, INVREQ, NOTFND, TEMPLATERR

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

MAXLENGTH(data-value)

CLNTCODEPAGE(name)

DATAONLY

Conditions: LENGERR, NOTFND

Chapter 1. Command-level application programming

25

API syntax

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

LENGTH(data-value) UNESCAPED

Conditions: NOTFND, SYMBOLERR

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

TRT

segmentlist

LENGTHLIST(data-area) NUMSEGMENTS(data-area)

TASK

STORAGE

PROGRAM

TERMINAL

TABLES

DCT

FCT

PCT

PPT

SIT

TCT

DUMPID(data-area)

segmentlist:
SEGMENTLIST(data-area)

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

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

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

26

CICS TS for z/OS: CICS Users Handbook

API syntax

ENQ
UOW ENQ RESOURCE(data-area) LENGTH(data-value) MAXLIFETIME(cvda) TASK NOSUSPEND

Conditions: ENQBUSY, INVREQ, LENGERR # This command is threadsafe if it is defined as LOCAL. It is non-threadsafe if it is defined as GLOBAL.

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

RESOURCE(name)

EXCEPTION

Conditions: INVREQ, LENGERR This command is threadsafe.

EXTRACT ATTACH (LUTYPE6.1)


EXTRACT ATTACH ATTACHID(name) CONVID(name) SESSION(name) PROCESS(data-area) RESOURCE(data-area)

RPROCESS(data-area)

RRESOURCE(data-area)

QUEUE(data-area)

IUTYPE(data-area)

DATASTR(data-area)

RECFM(data-area)

Conditions: CBIDERR, INVREQ, NOTALLOC

Chapter 1. Command-level application programming

27

API syntax

EXTRACT ATTACH (MRO)


EXTRACT ATTACH ATTACHID(name) CONVID(name) SESSION(name) PROCESS(data-area) RESOURCE(data-area)

RPROCESS(data-area)

RRESOURCE(data-area)

QUEUE(data-area)

IUTYPE(data-area)

DATASTR(data-area)

RECFM(data-area)

Conditions: CBIDERR, INVREQ, NOTALLOC

EXTRACT ATTRIBUTES (APPC)


EXTRACT ATTRIBUTES CONVID(name) STATE(cvda)

Conditions: INVREQ, NOTALLOC

EXTRACT ATTRIBUTES (MRO)


EXTRACT ATTRIBUTES CONVID(name) SESSION(name) STATE(cvda)

Conditions: INVREQ, NOTALLOC

28

CICS TS for z/OS: CICS Users Handbook

API syntax

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

OWNER SERIALNUMLEN(data-area) USERID(data-area) ISSUER COMMONNAME(ptr-ref)

COMMONNAMLEN(data-area)

COUNTRY(ptr-ref)

COUNTRYLEN(data-area)

STATE(ptr-ref)

STATELEN(data-area)

LOCALITY(ptr-ref)

LOCALITYLEN(data-area)

ORGANIZATION(ptr-ref)

ORGANIZATLEN(data-area)

ORGUNIT(ptr-ref)

ORGUNITLEN(data-area)

Conditions: INVREQ, LENGERR

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

Condition: NOTALLOC

Chapter 1. Command-level application programming

29

API syntax

EXTRACT PROCESS (APPC)


EXTRACT PROCESS PROCNAME(data-area) PROCLENGTH(data-area) maxproclen

CONVID(name)

SYNCLEVEL(data-area)

PIPLIST(ptr-ref) PIPLENGTH(data-area)

maxproclen:

MAXPROCLEN(data-value)

Conditions: INVREQ, LENGERR, NOTALLOC

EXTRACT TCPIP
EXTRACT TCPIP CLIENTNAME(data-area) CNAMELENGTH(data-area) AUTHENTICATE(cvda)

SERVERNAME(data-area) SNAMELENGTH(data-area) CLIENTADDR(data-area) CADDRLENGTH(data-area) CLIENTADDRNU(data-area) SERVERADDR(data-area) SADDRLENGTH(data-area) SERVERADDRNU(data-area)

SSLTYPE(cvda)

TCPIPSERVICE(data-area)

PORTNUMBER(data-area)

PORTNUMNU(data-area)

Conditions: INVREQ, LENGERR

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

Condition: INVREQ, NOTALLOC

30

CICS TS for z/OS: CICS Users Handbook

API syntax

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

DATEFORM(data-area)

DATESEP (data-value)

DAYCOUNT(data-area)

DAYOFMONTH(data-area)

DAYOFWEEK(data-area)

DDMMYY(data-area)

DDMMYYYY(data-area)

MMDDYY(data-area)

MMDDYYYY(data-area)

MONTHOFYEAR(data-area)

TIME(data-area) TIMESEP (data-value)

YEAR(data-area)

YYDDD(data-area)

YYDDMM(data-area)

YYMMDD(data-area)

YYYYDDD(data-area)

YYYYDDMM(data-area)

YYYYMMDD(data-area)

Condition: INVREQ

FREE
FREE

Condition: NOTALLOC

FREE (APPC)
FREE CONVID(name) STATE(cvda)

Conditions: INVREQ, NOTALLOC

Chapter 1. Command-level application programming

31

API syntax

FREE (LUTYPE6.1)
FREE CONVID(name) SESSION(name)

Conditions: INVREQ, NOTALLOC

FREE (MRO)
FREE CONVID(name) SESSION(name) STATE(cvda)

Conditions: INVREQ, NOTALLOC

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

Condition: INVREQ This command is threadsafe.

GDS ALLOCATE (APPC basic)


GDS ALLOCATE SYSID(systemname) MODENAME(name) PARTNER(name) RETCODE(data-area) NOQUEUE STATE(cvda) CONVID(data-area)

GDS ASSIGN (APPC basic)


GDS ASSIGN PRINCONVID(data-area) PRINSYSID(data-area) RETCODE(data-area)

32

CICS TS for z/OS: CICS Users Handbook

API syntax

GDS CONNECT PROCESS (APPC basic)


GDS CONNECT PROCESS CONVID(name) PROCNAME(name) PROCLENGTH(data-value) PARTNER(name) SYNCLEVEL(data-value) CONVDATA(data-area) PIPLIST(data-area) PIPLENGTH(data-value) RETCODE(data-area) STATE(cvda)

GDS EXTRACT ATTRIBUTES (APPC basic)


GDS EXTRACT ATTRIBUTES CONVID(name) STATE(cvda) RETCODE(data-area) CONVDATA(data-area)

GDS EXTRACT PROCESS (APPC basic)


GDS EXTRACT PROCESS CONVID(name)

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

maxproclen

SYNCLEVEL(data-area)

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

maxproclen:

MAXPROCLEN(data-value)

GDS FREE (APPC basic)


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

Chapter 1. Command-level application programming

33

API syntax

GDS ISSUE ABEND (APPC basic)


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

GDS ISSUE CONFIRMATION (APPC basic)


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

STATE(cvda)

GDS ISSUE ERROR (APPC basic)


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

GDS ISSUE PREPARE (APPC basic)


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

GDS ISSUE SIGNAL (APPC basic)


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

34

CICS TS for z/OS: CICS Users Handbook

API syntax

GDS RECEIVE (APPC basic)


GDS RECEIVE CONVID(name) INTO(data-area) SET(pointer-ref) BUFFER LLID FLENGTH(data-area)

CONVDATA(data-area) RETCODE(data-area)

MAXFLENGTH(data-value)

STATE(cvda)

GDS SEND (APPC basic)


GDS SEND CONVID(name) FROM(data-area) FLENGTH(data-value) CONVDATA(data-area) RETCODE(data-area) STATE(cvda) INVITE LAST CONFIRM WAIT

GDS WAIT (APPC basic)


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

GET COUNTER
GET COUNTER(name) POOL(name) VALUE(data-area) INCREMENT(data-value) REDUCE

WRAP

COMPAREMIN(data-value)

COMPAREMAX(data-value)

Conditions: INVREQ, LENGERR, SUPPRESSED

Chapter 1. Command-level application programming

35

API syntax

GETMAIN
GETMAIN SET(ptr-ref) FLENGTH(data-value) BELOW LENGTH(data-value) INITIMG(data-value)

SHARED

NOSUSPEND

USERDATAKEY CICSDATAKEY

Conditions: LENGERR, NOSTG This command is threadsafe.

HANDLE ABEND
CANCEL HANDLE ABEND PROGRAM(name) LABEL(label) RESET

Conditions: NOTAUTH, PGMIDERR (PROGRAM only) This command is threadsafe.

36

CICS TS for z/OS: CICS Users Handbook

API syntax

HANDLE AID

HANDLE AID ANYKEY (label) CLEAR (label) CLRPARTN (label) ENTER (label) LIGHTPEN (label) OPERID (label) PA1-PA3 (label) PF1-PF24 (label) TRIGGER (label)

Condition: INVREQ This command is threadsafe.

HANDLE CONDITION

HANDLE CONDITION

condition (label)

This command is threadsafe.

IGNORE CONDITION

IGNORE CONDITION

condition

This command is threadsafe.

Chapter 1. Command-level application programming

37

API syntax

ISSUE ABEND (APPC)


ISSUE ABEND CONVID(name) STATE(cvda)

Conditions: INVREQ, NOTALLOC, TERMERR

ISSUE ABORT
ISSUE ABORT DESTID(data-value) DESTIDLENG(data-value) CONSOLE SUBADDR(data-value) PRINT CARD WPMEDIA1 WPMEDIA2 WPMEDIA3 WPMEDIA4

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

Conditions: FUNCERR, INVREQ, SELNERR, UNEXPIN

ISSUE ADD
ISSUE ADD DESTID(data-value) DESTIDLENG(data-value) VOLUME(data-value) VOLUMELENG(data-value) FROM(data-area) LENGTH(data-value)

NUMREC(data-value)

DEFRESP

NOWAIT

RIDFLD(data-area) RRN

Conditions: FUNCERR, INVREQ, SELNERR, UNEXPIN

38

CICS TS for z/OS: CICS Users Handbook

API syntax

ISSUE CONFIRMATION (APPC)


ISSUE CONFIRMATION CONVID(name) STATE(cvda)

Conditions: INVREQ, NOTALLOC, SIGNAL, TERMERR

ISSUE COPY (3270 display)


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

Condition: NOTALLOC, TERMIDERR

ISSUE COPY (3270 logical)


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

Conditions: LENGERR, NOTALLOC, TERMERR

ISSUE DISCONNECT (default)


ISSUE DISCONNECT

Conditions: SIGNAL, TERMERR

ISSUE DISCONNECT (LUTYPE6.1)


ISSUE DISCONNECT SESSION(name)

Conditions: NOTALLOC, TERMERR

Chapter 1. Command-level application programming

39

API syntax

ISSUE END
ISSUE END DESTID(data-value) DESTIDLENG(data-value) CONSOLE SUBADDR(data-value) PRINT CARD WPMEDIA1 WPMEDIA2 WPMEDIA3 WPMEDIA4

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

Conditions: FUNCERR, INVREQ, SELNERR, UNEXPIN

ISSUE ENDFILE
ISSUE ENDFILE ENDOUTPUT

Condition: INVREQ, NOTALLOC

ISSUE ENDOUTPUT
ISSUE ENDOUTPUT ENDFILE

Condition: INVREQ, NOTALLOC

ISSUE EODS
ISSUE EODS

Conditions: INVREQ, NOTALLOC, TERMERR

40

CICS TS for z/OS: CICS Users Handbook

API syntax

ISSUE ERASE
ISSUE ERASE DESTID(data-value) DESTIDLENG(data-value) VOLUME(data-value) VOLUMELENG(data-value) KEYLENGTH(data-value) KEYNUMBER(data-value) RRN NUMREC(data-value) DEFRESP RIDFLD(data-area)

NOWAIT

Conditions: FUNCERR, INVREQ, SELNERR, UNEXPIN

ISSUE ERASEAUP
ISSUE ERASEAUP WAIT

Conditions: INVREQ, NOTALLOC, TERMERR

ISSUE ERROR (APPC)


ISSUE ERROR CONVID(name) STATE(cvda)

Conditions: INVREQ, NOTALLOC, SIGNAL, TERMERR

ISSUE LOAD
ISSUE LOAD PROGRAM(name) CONVERSE

Conditions: NONVAL, NOTALLOC, NOSTART, TERMERR

Chapter 1. Command-level application programming

41

API syntax

ISSUE NOTE
ISSUE NOTE DESTID(data-value) DESTIDLENG(data-value) VOLUME(data-value) VOLUMELENG(data-value) RIDFLD(data-area) RRN

Conditions: FUNCERR, INVREQ, SELNERR, UNEXPIN

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

NOQUIESCE

Conditions: INVREQ, LENGERR, NOTALLOC

ISSUE PREPARE (APPC)


ISSUE PREPARE CONVID(name) STATE(cvda)

Conditions: INVREQ, NOTALLOC, TERMERR

ISSUE PRINT
ISSUE PRINT

Conditions: INVREQ, NOTALLOC, TERMERR

42

CICS TS for z/OS: CICS Users Handbook

API syntax

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

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

Conditions: FUNCERR, INVREQ, SELNERR, UNEXPIN

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

LENGTH(data-area)

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

ISSUE REPLACE
ISSUE REPLACE DESTID(data-value) DESTIDLENG(data-value) FROM(data-area) VOLUME(data-value) VOLUMELENG(data-value) RIDFLD(data-area) NUMREC(data-value) RRN KEYLENGTH(data-value) KEYNUMBER(data-value) LENGTH(data-value)

DEFRESP

NOWAIT

Conditions: FUNCERR, INVREQ, SELNERR, UNEXPIN

ISSUE RESET
ISSUE RESET

Condition: INVREQ, NOTALLOC

Chapter 1. Command-level application programming

43

API syntax

ISSUE SEND
ISSUE SEND DESTID(data-value) DESTIDLENG(data-value) CONSOLE SUBADDR(data-value) PRINT CARD WPMEDIA1 WPMEDIA2 WPMEDIA3 WPMEDIA4 FROM(data-area) VOLUME(data-value) VOLUMELENG(data-value) LENGTH(data-value)

NOWAIT

DEFRESP

Conditions: FUNCERR, IGREQCD, INVREQ, SELNERR, UNEXPIN

ISSUE SIGNAL (APPC)


ISSUE SIGNAL CONVID(name) STATE(cvda)

Conditions: INVREQ, NOTALLOC, TERMERR

ISSUE SIGNAL (LUTYPE6.1)


ISSUE SIGNAL CONVID(name) SESSION(name)

Conditions: NOTALLOC, TERMERR

44

CICS TS for z/OS: CICS Users Handbook

API syntax

ISSUE WAIT
ISSUE WAIT DESTID(data-value) DESTIDLENG(data-value) CONSOLE SUBADDR(data-value) PRINT CARD WPMEDIA1 WPMEDIA2 WPMEDIA3 WPMEDIA4

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

Conditions: FUNCERR, INVREQ, SELNERR, UNEXPIN

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

SYSID(systemname) INPUTMSG(data-area)

SYNCONRETURN

TRANSID(name)

INPUTMSGLEN(data-value)

lengths:

LENGTH(data-value)

DATALENGTH(data-area)

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

LOAD
LOAD PROGRAM(name) SET(ptr-ref) LENGTH(data-area) FLENGTH(data-area) ENTRY(ptr-ref) HOLD

Conditions: INVREQ, LENGERR, NOTAUTH, PGMIDERR This command is threadsafe.

Chapter 1. Command-level application programming

45

API syntax

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

ENTRYNAME(data-area)

Condition: INVREQ This command is threadsafe.

POINT
POINT CONVID(name) SESSION(name)

Condition: NOTALLOC

POP HANDLE
POP HANDLE

Condition: INVREQ This command is threadsafe.

46

CICS TS for z/OS: CICS Users Handbook

API syntax

POST
INTERVAL(0) POST INTERVAL(hhmmss) TIME(hhmmss) SET(ptr-ref) REQID(name)

AFTER

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

AT

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

Conditions: EXPIRED, INVREQ

PURGE MESSAGE
PURGE MESSAGE

Conditions: Full BMS: INVREQ, TSIOERR

PUSH HANDLE
PUSH HANDLE

This command is threadsafe.

QUERY COUNTER
QUERY COUNTER(name) POOL(name) VALUE(data-area) MINIMUM(data-area)

MAXIMUM(data-area)

Conditions: INVREQ, LENGERR

Chapter 1. Command-level application programming

47

API syntax

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

LOGMESSAGE(cvda)

READ(cvda)

UPDATE(cvda)

CONTROL(cvda)

ALTER(cvda)

Conditions: INVREQ, LENGERR, NOTFND, QIDERR

READ
READ FILE(filename) UNCOMMITTED CONSISTENT REPEATABLE UPDATE TOKEN(data-area) INTO(data-area) SET(ptr-ref)

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

EQUAL SYSID(systemname) LENGTH(data-area) LENGTH(data-area) RBA RRN DEBKEY DEBREC GTEQ NOSUSPEND

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

48

CICS TS for z/OS: CICS Users Handbook

API syntax

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

UNCOMMITTED CONSISTENT REPEATABLE UPDATE TOKEN(data-area)

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

SYSID(systemname) LENGTH(data-area) LENGTH(data-area)

RBA RRN

NOSUSPEND

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

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

UNCOMMITTED CONSISTENT REPEATABLE UPDATE TOKEN(data-area)

RIDFLD(data-area) REQID(data-value) SYSID(systemname) LENGTH(data-area) LENGTH(data-area) RBA RRN

NOSUSPEND

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

READQ TD
READQ TD QUEUE(name) INTO(data-area) SET(ptr-ref)

LENGTH(data-area)

SYSID(systemname)

NOSUSPEND

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

Chapter 1. Command-level application programming

49

API syntax

READQ TS
READQ TS QUEUE(name) QNAME(name) INTO(data-area) SET(ptr-ref)

LENGTH(data-area)

NEXT NUMITEMS(data-area) ITEM(data-value) SYSID(systemname)

Conditions: INVREQ, IOERR, ISCINVREQ, ITEMERR, LENGERR, NOTAUTH, QIDERR, SYSIDERR This command is threadsafe.

RECEIVE (APPC)
RECEIVE CONVID(name) INTO(data-area) SET(ptr-ref) LENGTH(data-area) FLENGTH(data-area)

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

NOTRUNCATE

STATE(cvda)

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

RECEIVE (default)
RECEIVE INTO(data-area) SET(ptr-ref) NOTRUNCATE MAXLENGTH(data-area) LENGTH(data-value) FLENGTH(data-value)

Conditions: INVREQ, LENGERR, NOTALLOC

50

CICS TS for z/OS: CICS Users Handbook

API syntax

RECEIVE (LUTYPE2/LUTYPE3)
RECEIVE INTO(data-area) SET(ptr-ref) LENGTH(data-area) FLENGTH(data-area)

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

ASIS

BUFFER

NOTRUNCATE

Conditions: EOC, INVREQ, LENGERR, TERMERR

RECEIVE (LUTYPE4)
RECEIVE INTO(data-area) SET(ptr-ref) LENGTH(data-area) FLENGTH(data-area)

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

NOTRUNCATE

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

RECEIVE (LUTYPE6.1)
RECEIVE SESSION(name) INTO(data-area) SET(ptr-ref) LENGTH(data-area) FLENGTH(data-area)

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

NOTRUNCATE

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

RECEIVE (MRO)
RECEIVE SESSION(name) INTO(data-area) SET(ptr-ref) LENGTH(data-area) FLENGTH(data-area)

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

NOTRUNCATE

STATE(cvda)

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

Chapter 1. Command-level application programming

51

API syntax

RECEIVE (System/3)
RECEIVE INTO(data-area) SET(ptr-ref) LENGTH(data-area) FLENGTH(data-area)

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

NOTRUNCATE

ASIS

Conditions: INVREQ, LENGERR

RECEIVE (System/7)
RECEIVE INTO(data-area) SET(ptr-ref) LENGTH(data-area) FLENGTH(data-area)

PSEUDOBIN

ASIS

Conditions: INVREQ, LENGERR

RECEIVE (2260)
RECEIVE INTO(data-area) SET(ptr-ref) LENGTH(data-area) FLENGTH(data-area)

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

NOTRUNCATE

LEAVEKB

Conditions: INVREQ, LENGERR

RECEIVE (2741)
RECEIVE INTO(data-area) SET(ptr-ref) LENGTH(data-area) FLENGTH(data-area)

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

NOTRUNCATE

Conditions: INVREQ, LENGERR, RDATT

52

CICS TS for z/OS: CICS Users Handbook

API syntax

RECEIVE (2980)
RECEIVE INTO(data-area) SET(ptr-ref) PASSBK NOTRUNCATE LENGTH(data-area) FLENGTH(data-area)

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

Conditions: INVREQ, LENGERR, NOPASSBKRD

RECEIVE (3270 display)


RECEIVE INTO(data-area) SET(ptr-ref) LENGTH(data-area) FLENGTH(data-area)

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

NOTRUNCATE

ASIS

BUFFER

Conditions: INVREQ, LENGERR

RECEIVE (3270 logical)


RECEIVE INTO(data-area) SET(ptr-ref) LENGTH(data-area) FLENGTH(data-area)

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

ASIS

BUFFER

NOTRUNCATE

Conditions: INVREQ, LENGERR, TERMERR

RECEIVE (3600 BTAM)


RECEIVE INTO(data-area) SET(ptr-ref) LENGTH(data-area) FLENGTH(data-area)

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

NOTRUNCATE

Conditions: INVREQ, LENGERR

Chapter 1. Command-level application programming

53

API syntax

RECEIVE (3600 pipeline)


RECEIVE INTO(data-area) SET(ptr-ref) LENGTH(data-area) FLENGTH(data-area)

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

NOTRUNCATE

Conditions: INVREQ, LENGERR, NOTALLOC

RECEIVE (3600-3601)
RECEIVE INTO(data-area) SET(ptr-ref) LENGTH(data-area) FLENGTH(data-area)

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

NOTRUNCATE

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

RECEIVE (3600-3614)
RECEIVE INTO(data-area) SET(ptr-ref) LENGTH(data-area) FLENGTH(data-area)

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

NOTRUNCATE

Conditions: INVREQ, LENGERR, TERMERR

RECEIVE (3650)
RECEIVE INTO(data-area) SET(ptr-ref) LENGTH(data-area) FLENGTH(data-area)

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

NOTRUNCATE

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

54

CICS TS for z/OS: CICS Users Handbook

API syntax

RECEIVE (3735)
RECEIVE INTO(data-area) SET(ptr-ref) LENGTH(data-area) FLENGTH(data-area)

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

NOTRUNCATE

Conditions: EOF, INVREQ, LENGERR

RECEIVE (3740)
RECEIVE INTO(data-area) SET(ptr-ref) LENGTH(data-area) FLENGTH(data-area)

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

NOTRUNCATE

Conditions: EOF, ENDINPT, INVREQ, LENGERR

RECEIVE (3767)
RECEIVE INTO(data-area) SET(ptr-ref) LENGTH(data-area) FLENGTH(data-area)

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

NOTRUNCATE

Conditions: EOC, INVREQ, LENGERR, SIGNAL, TERMERR

RECEIVE (3770)
RECEIVE INTO(data-area) SET(ptr-ref) LENGTH(data-area) FLENGTH(data-area)

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

NOTRUNCATE

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

Chapter 1. Command-level application programming

55

API syntax

RECEIVE (3790 full-function or inquiry)


RECEIVE INTO(data-area) SET(ptr-ref) LENGTH(data-area) FLENGTH(data-area)

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

NOTRUNCATE

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

RECEIVE (3790 3270-display)


RECEIVE INTO(data-area) SET(ptr-ref) LENGTH(data-area) FLENGTH(data-area)

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

ASIS

BUFFER

NOTRUNCATE

Conditions: INVREQ, LENGERR, TERMERR

RECEIVE MAP
RECEIVE MAP(name) MAPSET(name) INTO(data-area) SET(ptr-ref)

TERMINAL FROM(data-area) LENGTH(data-value) TERMINAL ASIS INPARTN(name)

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

56

CICS TS for z/OS: CICS Users Handbook

API syntax

RECEIVE MAP MAPPINGDEV


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

MAPSET(name)

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

Conditions: INVMPSZ, INVREQ, MAPFAIL,

RECEIVE PARTN
RECEIVE PARTN(data-area)

Standard and full BMS:

RECEIVE PARTN
INTO(data-area) SET(ptr-ref) LENGTH(data-value) ASIS

Conditions: EOC, EODS, INVPARTN, INVREQ, LENGERR

RELEASE
RELEASE PROGRAM(name)

Conditions: INVREQ, NOTAUTH, PGMIDERR This command is threadsafe.

Chapter 1. Command-level application programming

57

API syntax

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

GTEQ REQID(data-value) SYSID(systemname) EQUAL RBA RRN

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

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

LENGTH(data-area)

RTRANSID(data-area)

RTERMID(data-area)

QUEUE(data-area)

WAIT

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

RETURN
RETURN TRANSID(name) commarea IMMEDIATE

INPUTMSG(data-area) INPUTMSGLEN(data-value)

ENDACTIVITY

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

Conditions: INVREQ, LENGERR

58

CICS TS for z/OS: CICS Users Handbook

API syntax

REWIND COUNTER
REWIND COUNTER(name) POOL(name) INCREMENT(data-value)

Conditions: INVREQ, SUPPRESSED

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

SYSID(systemname) LENGTH(data-value) LENGTH(data-value)

NOSUSPEND

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

ROUTE
INTERVAL(0) ROUTE INTERVAL(hhmmss) TIME(hhmmss) ERRTERM (name) TITLE(data-area)

AFTER

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

AT

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

LIST(data-area)

OPCLASS(data-area)

REQID(name)

LDC(name)

NLEOM

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

Chapter 1. Command-level application programming

59

API syntax

SEND (APPC)
SEND CONVID(name) FROM(data-area) LENGTH(data-value) FLENGTH(data-value) INVITE LAST CONFIRM WAIT

STATE(cvda)

Conditions: INVREQ, LENGERR, NOTALLOC, SIGNAL, TERMERR

SEND (default)
SEND FROM(data-area) LENGTH(data-value) FLENGTH(data-value)

DEST(name)

WAIT

Conditions: INVREQ, LENGERR, NOTALLOC

SEND (LUTYPE2/LUTYPE3)
SEND FROM(data-area) LENGTH(data-value) FLENGTH(data-value)

WAIT

INVITE LAST

ERASE DEFAULT ALTERNATE STRFIELD

CTLCHAR(data-value)

DEFRESP

Conditions: INVREQ, LENGERR, TERMERR

SEND (LUTYPE4)
SEND FROM(data-area) LENGTH(data-value) FLENGTH(data-value)

WAIT

INVITE LAST

CNOTCOMPL DEFRESP

FMH

Conditions: INVREQ, IGREQCD, LENGERR, SIGNAL, TERMERR

60

CICS TS for z/OS: CICS Users Handbook

API syntax

SEND (LUTYPE6.1)
SEND SESSION(name) WAIT INVITE LAST ATTACHID(name) FROM(data-area)

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

FMH

DEFRESP

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

SEND (MRO)
SEND SESSION(name) WAIT INVITE LAST ATTACHID(name) FROM(data-area)

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

FMH

DEFRESP

STATE(cvda)

Conditions: CBIDERR, INVREQ, LENGERR, NOTALLOC, TERMERR

SEND (SCS)
SEND FROM(data-area) LENGTH(data-value) FLENGTH(data-value)

WAIT

INVITE LAST

CNOTCOMPL DEFRESP

STRFIELD

FMH

Conditions: INVREQ, LENGERR, TERMERR

Chapter 1. Command-level application programming

61

API syntax

SEND (System/3)
SEND FROM(data-area) LENGTH(data-value) FLENGTH(data-value)

DEST(name)

WAIT

ASIS

CNOTCOMPL

Conditions: INVREQ, LENGERR

SEND (System/7)
SEND FROM(data-area) LENGTH(data-value) FLENGTH(data-value)

DEST(name)

WAIT

PSEUDOBIN

ASIS

Conditions: INVREQ, LENGERR

SEND (2260)
SEND FROM(data-area) LENGTH(data-value) FLENGTH(data-value)

CTLCHAR(data-value)

DEST(name)

LINEADDR(data-value)

WAIT

LEAVEKB

Conditions: INVREQ, LENGERR

SEND (2741)
SEND FROM(data-area) LENGTH(data-value) FLENGTH(data-value)

DEST(name)

WAIT

Conditions: INVREQ, LENGERR, WRBRK

62

CICS TS for z/OS: CICS Users Handbook

API syntax

SEND (2980)
SEND FROM(data-area) LENGTH(data-value) FLENGTH(data-value) PASSBK CBUFF

DEST(name)

Conditions: INVREQ, LENGERR, NOPASSBKWR

SEND (3270 display)


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

DEST(name)

WAIT

ERASE DEFAULT ALTERNATE STRFIELD

CTLCHAR(data-value)

Conditions: INVREQ, LENGERR

SEND (3270 logical)


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

WAIT

INVITE LAST

ERASE DEFAULT ALTERNATE STRFIELD

CTLCHAR(data-value)

DEFRESP

Conditions: INVREQ, LENGERR, TERMERR

SEND (3600 BTAM)


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

WAIT

ASIS

Conditions: INVREQ, LENGERR

Chapter 1. Command-level application programming

63

API syntax

SEND (3600 pipeline)


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

WAIT

Conditions: INVREQ, LENGERR, TERMERR

SEND (3600-3601)
SEND FROM(data-area) LENGTH(data-value) FLENGTH(data-value)

LDC(name) FMH

WAIT

INVITE LAST

CNOTCOMPL DEFRESP

Conditions: INVREQ, LENGERR, SIGNAL, TERMERR

SEND (3600-3614)
SEND FROM(data-area) LENGTH(data-value) FLENGTH(data-value)

WAIT

INVITE LAST

CNOTCOMPL DEFRESP

Conditions: INVREQ, LENGERR, TERMERR

SEND (3650 interpreter)


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

WAIT

INVITE LAST

DEFRESP

FMH

Conditions: INVREQ, LENGERR, TERMERR

64

CICS TS for z/OS: CICS Users Handbook

API syntax

SEND (3650-3270)
SEND FROM(data-area) LENGTH(data-value) FLENGTH(data-value)

CTLCHAR(data-value)

WAIT

ERASE DEFAULT ALTERNATE

INVITE LAST

CNOTCOMPL DEFRESP

FMH

Conditions: INVREQ, LENGERR, TERMERR

SEND (3650-3653)
SEND FROM(data-area) LENGTH(data-value) FLENGTH(data-value)

WAIT

INVITE LAST

CNOTCOMPL DEFRESP

Conditions: INVREQ, LENGERR, TERMERR

SEND (3650-3680)
SEND FROM(data-area) LENGTH(data-value) FLENGTH(data-value)

WAIT

INVITE LAST

CNOTCOMPL DEFRESP

FMH

Conditions: INVREQ, LENGERR, TERMERR

SEND (3735)
SEND FROM(data-area) LENGTH(data-value) FLENGTH(data-value)

WAIT

ASIS

Conditions: INVREQ, LENGERR

Chapter 1. Command-level application programming

65

API syntax

SEND (3740)
SEND FROM(data-area) LENGTH(data-value) FLENGTH(data-value)

WAIT

ASIS

Conditions: INVREQ, LENGERR

SEND (3767)
SEND FROM(data-area) LENGTH(data-value) FLENGTH(data-value)

WAIT

INVITE LAST

CNOTCOMPL DEFRESP

Conditions: INVREQ, LENGERR, SIGNAL, TERMERR

SEND (3770)
SEND FROM(data-area) LENGTH(data-value) FLENGTH(data-value)

WAIT

INVITE LAST

CNOTCOMPL DEFRESP

FMH

Conditions: INVREQ, LENGERR, SIGNAL, TERMERR

SEND (3790 full-function or inquiry)


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

WAIT

INVITE LAST

CNOTCOMPL DEFRESP

FMH

Conditions: INVREQ, LENGERR, SIGNAL, TERMERR

SEND (3790 SCS)


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

WAIT

INVITE LAST

CNOTCOMPL DEFRESP

Conditions: INVREQ, LENGERR, TERMERR

66

CICS TS for z/OS: CICS Users Handbook

API syntax

SEND (3790 3270-display)


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

CTLCHAR(data-value)

WAIT

ERASE DEFAULT ALTERNATE

INVITE LAST

DEFRESP

Conditions: INVREQ, LENGERR, TERMERR

SEND (3790 3270-printer)


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

CTLCHAR(data-value)

WAIT

ERASE DEFAULT ALTERNATE

INVITE LAST

DEFRESP

Conditions: INVREQ, LENGERR, TERMERR

SEND CONTROL
SEND CONTROL

SEND CONTROL Minimum BMS

CURSOR (data-value)

FORMFEED

ERASE DEFAULT ALTERNATE ERASEAUP

PRINT

FREEKB

ALARM

FRSET

Chapter 1. Command-level application programming

67

API syntax

SEND CONTROL Standard BMS

MSR(data-value)

OUTPARTN(name) LDC(name)

ACTPARTN(name)

SEND CONTROL Full BMS


TERMINAL ACCUM SET(ptr-ref) PAGING TERMINAL WAIT REQID(name) HONEOM L40 L64 L80

LAST

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

SEND MAP
SEND MAP(name)

SEND MAP Minimum BMS

MAPSET(name)

FROM(data-area) MAPONLY

DATAONLY

LENGTH(data-value)

CURSOR (data-value)

FORMFEED

ERASE DEFAULT ALTERNATE ERASEAUP

PRINT

FREEKB

ALARM

FRSET

68

CICS TS for z/OS: CICS Users Handbook

API syntax

SEND MAP Standard BMS

NLEOM

MSR(data-value)

FMHPARM(name)

OUTPARTN(name) LDC(name)

ACTPARTN(name)

SEND MAP Full BMS


TERMINAL ACCUM SET(ptr-ref) PAGING TERMINAL WAIT REQID(name) NOFLUSH L40 L64 L80 HONEOM

LAST

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

Minimum BMS:

SEND MAP MAPPINGDEV


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

FROM(data-area) MAPONLY

DATAONLY

LENGTH(data-value)

CURSOR (data-value)

FORMFEED

ERASE ERASEAUP

PRINT

FREEKB

ALARM

FRSET

Conditions: INVMPSZ, INVREQ

Chapter 1. Command-level application programming

69

API syntax

SEND PAGE
SEND PAGE RELEASE TRANSID(name) RETAIN TRAILER(data-area) SET(ptr-ref)

AUTOPAGE CURRENT ALL NOAUTOPAGE

OPERPURGE

FMHPARM(name)

LAST

Conditions: IGREQCD, INVREQ, RETPAGE, TSIOERR, WRBRK

SEND PARTNSET
SEND PARTNSET (name)

Conditions: INVPARTNSET, INVREQ

SEND TEXT
SEND TEXT

SEND TEXT Standard BMS


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

ERASE DEFAULT ALTERNATE

PRINT

FREEKB

ALARM

NLEOM

FMHPARM(name)

OUTPARTN(name) LDC(name)

ACTPARTN(name)

MSR(data-value)

70

CICS TS for z/OS: CICS Users Handbook

API syntax

SEND TEXT Full BMS


TERMINAL SET(ptr-ref) PAGING TERMINAL WAIT REQID(name) HEADER(data-area)

LAST HONEOM

TRAILER(data-area)

JUSTIFY(data-value) JUSFIRST JUSLAST

ACCUM

L40 L64 L80

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

SEND TEXT MAPPED


TERMINAL SEND TEXT MAPPED FROM(data-area) LENGTH(data-value) PAGING TERMINAL WAIT LAST

REQID(name)

Conditions: IGREQCD, IGREQID, INVREQ, TSIOERR, WRBRK

Chapter 1. Command-level application programming

71

API syntax

SEND TEXT NOEDIT


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

TERMINAL PRINT FREEKB ALARM OUTPARTN(name) TERMINAL WAIT PAGING HONEOM REQID(name) L40 L64 L80 LAST

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

SIGNOFF
SIGNOFF

Condition: INVREQ

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

GROUPID(data-value)

LANGUAGECODE(data-value) NATLANG(data-value)

LANGINUSE(data-area)

NATLANGINUSE(data-area)

PASSWORD(data-value)

NEWPASSWORD(data-value)

OIDCARD(data-value)

Conditions: INVREQ, NOTAUTH, USERIDERR

72

CICS TS for z/OS: CICS Users Handbook

API syntax

SPOOLCLOSE TOKEN

SPOOLCLOSE TOKEN(data-area) KEEP DELETE

NOHANDLE RESP RESP2

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

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

NOHANDLE RESP RESP2

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

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

NOCC CLASS(data-value) OUTDESCR(ptr-ref) ASA MCC

PRINT PRINT RECORDLENGTH(data-value) PUNCH

NOHANDLE RESP RESP2

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

Chapter 1. Command-level application programming

73

API syntax

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

TOFLENGTH(data-area)

NOHANDLE RESP RESP2

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

SPOOLWRITE
LINE SPOOLWRITE TOKEN(data-area) FROM(data-area) FLENGTH(data-value) PAGE

NOHANDLE RESP RESP2

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

74

CICS TS for z/OS: CICS Users Handbook

API syntax

START
INTERVAL(0) START TRANSID(name) INTERVAL(hhmmss) TIME(hhmmss) REQID(name)

AFTER

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

AT

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

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

TERMID(name) USERID(data-value)

SYSID(systemname)

RTRANSID(name)

RTERMID(name)

QUEUE(name)

NOCHECK

PROTECT

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

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

Conditions: INVREQ, LENGERR, NOTAUTH, TRANSIDERR

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

USERID(data-value)

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

Chapter 1. Command-level application programming

75

API syntax

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

REQID(data-value)

SYSID(systemname)

RBA RRN DEBKEY DEBREC

GTEQ EQUAL

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

SUSPEND
SUSPEND

This command is threadsafe.

SYNCPOINT
SYNCPOINT

Conditions: INVREQ, ROLLEDBACK

SYNCPOINT ROLLBACK
SYNCPOINT ROLLBACK

Condition: INVREQ

76

CICS TS for z/OS: CICS Users Handbook

API syntax

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

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

UPDATE COUNTER
UPDATE COUNTER(name) POOL(name) VALUE(data-value) COMPAREMIN(data-value)

COMPAREMAX(data-value)

Conditions: INVREQ, SUPPRESSED

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

DAYSLEFT(data-area)

ESMREASON(data-area)

ESMRESP(data-area)

EXPIRYTIME(data-area)

INVALIDCOUNT(data-area)

LASTUSETIME(data-area)

Conditions: INVREQ, NOTAUTH, USERIDERR

WAIT CONVID (APPC)


WAIT CONVID(name) STATE(cvda)

Conditions: INVREQ, NOTALLOC

Chapter 1. Command-level application programming

77

API syntax

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

Condition: INVREQ

WAIT EXTERNAL
PURGEABLE WAIT EXTERNAL ECBLIST(ptr-value) NUMEVENTS(data-value) PURGEABILITY(cvda) NOTPURGEABLE

NAME(name)

Condition: INVREQ This command is threadsafe.

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

Conditions: IOERR, JIDERR, NOTOPEN

WAIT SIGNAL
WAIT SIGNAL

Conditions: NOTALLOC, SIGNAL, TERMERR

78

CICS TS for z/OS: CICS Users Handbook

API syntax

WAIT TERMINAL
WAIT TERMINAL CONVID(name) SESSION(name)

Conditions: INVREQ, NOTALLOC, SIGNAL

WAITCICS
PURGEABLE WAITCICS ECBLIST(ptr-value) NUMEVENTS(data-value) PURGEABILITY(cvda) NOTPURGEABLE NAME(name)

Condition: INVREQ

WEB ENDBROWSE HTTPHEADER


WEB ENDBROWSE HTTPHEADER

Conditions: INVREQ

WEB ENDBROWSE FORMFIELD


WEB ENDBROWSE FORMFIELD

Conditions: INVREQ

Chapter 1. Command-level application programming

79

API syntax

WEB EXTRACT
WEB EXTRACT HTTPMETHOD(data-area) METHODLENGTH(data-value)

HTTPVERSION(data-area) VERSIONLEN(data-value)

PATH(data-area) PATHLENGTH(data-value)

QUERYSTRING(data-area) QUERYSTRLEN(data-value)

REQUESTTYPE(cvda)

Conditions: INVREQ, LENGERR

WEB READ HTTPHEADER


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

Conditions: INVREQ, LENGERR, NOTFND

WEB READ FORMFIELD


WEB READ FORMFIELD(data-area) NAMELENGTH(data-value) VALUELENGTH(data-area) CLNTCODEPAGE(name) HOSTCODEPAGE(name) VALUE(data-area) SET(ptr-ref)

Conditions: INVREQ, LENGERR, NOTFND

WEB READNEXT HTTPHEADER


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

Conditions: ENDFILE, INVREQ, LENGERR

80

CICS TS for z/OS: CICS Users Handbook

API syntax

WEB READNEXT FORMFIELD


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

Conditions: ENDFILE, INVREQ, LENGERR

WEB RECEIVE
WEB RECEIVE INTO(data-area) SET(ptr-ref) LENGTH(data-area) MAXLENGTH(data-value)

TYPE(cvda)

NOTRUNCATE

CLNTCODEPAGE(name) HOSTCODEPAGE(name)

Conditions: INVREQ, LENGERR, NOTFND

WEB RETRIEVE
WEB RETRIEVE DOCTOKEN(data-area)

Conditions:INVREQ

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

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

Conditions:INVREQ, NOTFND

Chapter 1. Command-level application programming

81

API syntax

WEB STARTBROWSE HTTPHEADER


WEB STARTBROWSE HTTPHEADER

Conditions: INVREQ

WEB STARTBROWSE FORMFIELD


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

CLNTCODEPAGE(name) HOSTCODEPAGE(name)

Conditions: INVREQ, LENGERR, NOTFND

WEB WRITE HTTPHEADER


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

VALUELENGTH(data-value)

Conditions:INVREQ

WRITE
WRITE FILE(filename) MASSINSERT FROM(data-area) RIDFLD(data-area)

KEYLENGTH(data-value)

SYSID(systemname) LENGTH(data-value) LENGTH(data-value)

RBA RRN

NOSUSPEND

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

82

CICS TS for z/OS: CICS Users Handbook

API syntax

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

REQID(data-area)

PREFIX(data-value) PFXLENG(data-value)

WAIT

NOSUSPEND

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

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

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

EVENTUAL ACTION(cvda) CRITICAL IMMEDIATE REPLY(data-area)

lengths TIMEOUT(data-value)

lengths:
MAXLENGTH(data-area) REPLYLENGTH(data-area)

Conditions: EXPIRED, INVREQ, LENGERR

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

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

Chapter 1. Command-level application programming

83

API syntax

WRITEQ TS
WRITEQ TS QUEUE(name) QNAME(name) FROM(data-area) LENGTH(data-value)

AUXILIARY NUMITEMS(data-area) ITEM(data-area) REWRITE SYSID(systemname) MAIN NOSUSPEND

Conditions: INVREQ, IOERR, ISCINVREQ, ITEMERR, LENGERR, LOCKED, NOSPACE, NOTAUTH, QIDERR, SYSIDERR This command is threadsafe.

XCTL
XCTL PROGRAM(name) COMMAREA(data-area) LENGTH(data-value)

INPUTMSG(data-area) INPUTMSGLEN(data-value)

Conditions: INVREQ, LENGERR, NOTAUTH, PGMIDERR This command is threadsafe.

84

CICS TS for z/OS: CICS Users Handbook

Chapter 2. SPI command syntax


This chapter contains General-use Programming Interface information.

ACQUIRE TERMINAL
ACQUIRE TERMINAL(data-value) NOQUEUE QALL RELREQ QNOTENAB QSESSLIM RELREQ

USERDATA(data-value) USERDATALEN(data-value)

Conditions: INVREQ, LENGERR, NOTAUTH, TERMIDERR

| | | | | |

COLLECT STATISTICS
COLLECT STATISTICS SET(ptr-ref) last time resource types

Conditions: INVREQ, IOERR, NOTAUTH, NOTFND

Copyright IBM Corp. 1989, 2002

85

SPI syntax

last time:
LASTRESET(data-area) hours minutes

seconds

hours:
LASTRESETHRS(data-area)

minutes:
LASTRESETMIN(data-area)

seconds:
LASTRESETSEC(data-area)

86

CICS TS for z/OS: CICS Users Handbook

SPI syntax

| |

resource types:
AUTOINSTALL CONNECTION(data-value) CORBASERVER(data-value) DB2CONN DB2ENTRY(data-value) DISPATCHER ENQUEUE FILE(data-value) JOURNALNAME(data-value) JOURNALNUM(data-value) JVMPOOL LSRPOOL(data-value) MONITOR (data-value) MVSTCB (data-value) POOL(data-value) TARGET(data-value) PROGAUTO PROGRAM (data-value) RECOVERY REQUESTMODEL(data-value) STATS STORAGE (data-value) STREAMNAME (data-value) SYSDUMPCODE (data-value) TABLEMGR TARGET(data-value) NODE(data-value) TCLASS(data-value) TCPIP TCPIPSERVICE(data-value) TDQUEUE (data-value) TERMINAL(data-value) TRANCLASS(data-value) TRANDUMPCODE (data-value) TRANSACTION (data-value) TSQUEUE VTAM

| | |

Chapter 2. SPI command syntax

87

SPI syntax

CREATE CONNECTION
CREATE CONNECTION(data-value) ATTRIBUTES(data-value) ATTRLEN(data-value) LOGMESSAGE(cvda) COMPLETE DISCARD

CREATE CONNECTION attribute values:


ACCESSMETHOD(VTAM) ACCESSMETHOD(INDIRECT) ACCESSMETHOD(IRC) ACCESSMETHOD(XM) ATTACHSEC(LOCAL) ATTACHSEC(IDENTIFY) ATTACHSEC(MIXIDPE) ATTACHSEC(PERSISTENT) ATTACHSEC(VERIFY) AUTOCONNECT(NO) AUTOCONNECT(ALL) AUTOCONNECT(YES)

BINDSECURITY(NO) BINDSECURITY(YES)

CONNTYPE(SPECIFIC) CONNTYPE(GENERIC)

DATASTREAM(USER) DATASTREAM(LMS) DATASTREAM(SCS) DATASTREAM(STRFIELD) DATASTREAM(3270) INSERVICE(YES) MAXQTIME(NO) MAXQTIME(0-9999) QUEUELIMIT(NO) QUEUELIMIT(0-9999)

DESCRIPTION(char58)

INDSYS(char4)

INSERVICE(NO) PSRECOVERY(SYSDEFAULT)

NETNAME(char8)

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

PSRECOVERY(NONE)

RECORDFORMAT(U) RECORDFORMAT(VB) REMOTESYSNET(char8) REMOTESYSTEM(char4) REMOTENAME(char4) SINGLESESS(NO) SECURITYNAME(char8) SINGLESESS(YES) USEDFLTUSER(NO) USEDFLTUSER(YES) XLNACTION(KEEP) XLNACTION(FORCE)

Conditions: ILLOGIC, INVREQ, LENGERR, NOTAUTH

CREATE CORBASERVER
CREATE CORBASERVER(data-value) ATTRIBUTES(data-value) ATTRLEN(data-value) LOGMESSAGE(cvda)

Conditions: ILLOGIC, INVREQ, LENGERR, NOTAUTH

88

CICS TS for z/OS: CICS Users Handbook

SPI syntax

| | |

CREATE CORBASERVER attributes:


AUTOPUBLISH(NO) DESCRIPTION(char58) DJARDIR(char255) AUTOPUBLISH(YES) JNDIPREFIX(char255)

| | | |

SESSBEANTIME(00,00,10) SESSBEANTIME(int2, int2, int2)

SHELF(/var/cicsts) HOST(char255) SHELF(char255)

STATE(cvda) UNAUTH(char8) CERTIFICATE(char56) CLIENTCERT(char8) SSLUNAUTH(char8)

| | |

Chapter 2. SPI command syntax

89

SPI syntax

| | | | | |

CREATE DB2CONN
CREATE DB2CONN(data-value) ATTRIBUTES(data-value) ATTRLEN(data-value) LOGMESSAGE(cvda)

CREATE DB2CONN attribute values:


CONNECTERROR(sqlcode) DESCRIPTION(char58) CONNECTERROR(abend) DB2GROUPID(char4) DB2ID(char4) NONTERMREL(yes) MSGQUEUE2(char4) MSGQUEUE3(char4) NONTERMREL(no) STANDBYMODE(reconnect) SIGNID(char8) STANDBYMODE(noconnect) STANDBYMODE(connect) ACCOUNTREC(none) ACCOUNTREC(uow) ACCOUNTREC(task) ACCOUNTREC(txid)

| | | |

MSGQUEUE1(CDB2) MSGQUEUE1(char4) PURGECYCLE(0,30) PURGECYCLE(0-59,0-59)

RESYNCMEMBER(yes) RESYNCMEMBER(no)

| |

STATSQUEUE(CDB2) STATSQUEUE(char4)

TCBLIMIT(12) TCBLIMIT(4-2000)

THREADERROR(n906d) THREADERROR(abend) THREADERROR(n906)

| |
AUTHID(char8)

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

DROLLBACK(yes) DROLLBACK(no) PLAN(char8)

| |

PLANEXITNAME(DSNCUEXT) PLANEXITNAME(char8)

PRIORITY(high) PRIORITY(equal) PRIORITY(low)

THREADLIMIT(3) THREADLIMIT(3-2000)

THREADWAIT(yes) THREADWAIT(no)

| |
COMAUTHID(char8)

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

COMTHREADLIM(1) COMTHREADLIM(0-2000)

| | | | Conditions: ILLOGIC, INVREQ, LENGERR, NOTAUTH

90

CICS TS for z/OS: CICS Users Handbook

SPI syntax

CREATE DB2ENTRY
CREATE DB2ENTRY(data-value) ATTRIBUTES(data-value) ATTRLEN(data-value) LOGMESSAGE(cvda)

CREATE DB2ENTRY attribute values:


ACCOUNTREC(none) DESCRIPTION(char58) TRANSID(char4) ACCOUNTREC(uow) ACCOUNTREC(task) ACCOUNTREC(txid) AUTHID(char8)

AUTHTYPE(userid) AUTHTYPE(group) AUTHTYPE(signid) AUTHTYPE(term) AUTHTYPE(txid) AUTHTYPE(opid) PRIORITY(high) PRIORITY(equal) PRIORITY(low)

DROLLBACK(yes) DROLLBACK(no) PLAN(char8)

PLANEXITNAME(DSNCUEXT) PLANEXITNAME(char8)

PROTECTNUM(0) PROTECTNUM(0-2000)

THREADLIMIT(0) THREADLIMIT(0-2000)

THREADWAIT(pool) THREADWAIT(yes) THREADWAIT(no)

Conditions: ILLOGIC, INVREQ, LENGERR, NOTAUTH

CREATE DB2TRAN
CREATE DB2TRAN(data-value) ATTRIBUTES(data-value) ATTRLEN(data-value) LOGMESSAGE(cvda)

CREATE DB2TRAN attribute values:


ENTRY(char8) DESCRIPTION(char58) TRANSID(char4)

Conditions: ILLOGIC, INVREQ, LENGERR, NOTAUTH

CREATE DJAR
CREATE DJAR(data-value) ATTRIBUTES(data-value) ATTRLEN(data-value)

Conditions: ILLOGIC, INVREQ, LENGERR, NOTAUTH

Chapter 2. SPI command syntax

91

SPI syntax

CREATE DJAR attributes:


CORBASERVER(char4) HFSFILE(char255) DESCRIPTION(char58)

CREATE DOCTEMPLATE
CREATE DOCTEMPLATE(data-value) ATTRIBUTES(data-value) ATTRLEN(data-value) LOGMESSAGE(cvda)

CREATE DOCTEMPLATE attribute values:


APPENDCRLF(YES) APPENDCRLF(NO) DESCRIPTION(char58) FILE(char8) TSQUEUE(char16) TDQUEUE(char4) PROGRAM(char8) EXITPGM(char8) DDNAME(DFHHTML) MEMBERNAME(char8) DDNAME(char8)

TEMPLATENAME(char48)

Conditions: ILLOGIC, INVREQ, LENGERR, NOTAUTH

CREATE ENQMODEL
CREATE ENQMODEL(data-value) ATTRIBUTES(data-value) ATTRLEN(data-value) LOGMESSAGE(cvda)

CREATE ENQMODEL attribute values:


STATUS(ENABLED) ENQNAME(char1-255) DESCRIPTION(char58) ENQSCOPE(char4) STATUS(DISABLED)

Conditions: INVREQ, LENGERR, NOTAUTH

92

CICS TS for z/OS: CICS Users Handbook

SPI syntax

CREATE FILE
CREATE FILE(data-value) ATTRIBUTES(data-value) ATTRLEN(data-value) LOGMESSAGE(cvda)

Conditions: ILLOGIC, INVREQ, LENGERR, NOTAUTH

CREATE FILE attribute values (part 1):


ADD(NO) ADD(YES) DATABUFFERS(2) DATABUFFERS(2-32767) BACKUPTYPE(STATIC) BACKUPTYPE(DYNAMIC) DELETE(NO) DELETE(YES) DESCRIPTION(char58) FWDRECOVLOG(NO) FWDRECOVLOG(1-99) JNLREAD(NONE) JNLREAD(ALL) JNLREAD(READONLY) JNLREAD(UPDATEONLY) JOURNAL(NO) JOURNAL(1-99) LSRPOOLID(1) LSRPOOLID(NONE) LSRPOOLID(1-8) OPENTIME(FIRSTREF) NSRGROUP(char8) OPENTIME(STARTUP) PASSWORD(char8) JNLSYNCREAD(NO) JNLSYNCREAD(YES) BROWSE(NO) BROWSE(YES) CFDTPOOL(char8) DISPOSITION(SHARE) DISPOSITION(OLD)

DSNSHARING(ALLREQS) DSNAME(char44) INDEXBUFFERS(1) INDEXBUFFERS(1-32767) DSNSHARING(MODIFYREQS) JNLADD(NONE) JNLADD(AFTER) JNLADD(ALL) JNLADD(BEFORE) JNLUPDATE(NO) JNLUPDATE(YES)

JNLSYNCWRITE(YES) JNLSYNCWRITE(NO)

LOAD(NO) KEYLENGTH(1-255|1-16 for CFDT) LOAD(YES)

MAXNUMRECS(NOLIMIT) MAXNUMRECS(1-99999999) READ(YES) READ(NO)

READINTEG(UNCOMMITTED) READINTEG(CONSISTENT) READINTEG(REPEATABLE)

RECORDFORMAT(V) RECORDFORMAT(F)

Chapter 2. SPI command syntax

93

SPI syntax

CREATE FILE attributes (part 2):


RECOVERY(NONE) RECORDSIZE(1-32767) RECOVERY(ALL) RECOVERY(BACKOUTONLY) RLSACCESS(NO) REMOTESYSTEM(char4) REMOTENAME(char8) STRINGS(1) STRINGS(1-255) TABLE(NO) TABLE(CF) TABLE(CICS) TABLE(USER) TABLENAME(char8) RLSACCESS(YES) STATUS(ENABLED) STATUS(DISABLED) STATUS(UNENABLED)

UPDATE(NO) UPDATE(YES)

UPDATEMODEL(LOCKING) UPDATEMODEL(CONTENTION)

CREATE JOURNALMODEL
CREATE JOURNALMODEL(data-value) ATTRIBUTES(data-value) ATTRLEN(data-value) LOGMESSAGE(cvda)

CREATE JOURNALMODEL attribute values:


STREAMNAME(&USERID..&APPLID..&JNAME;) DESCRIPTION(char58) TYPE(MVS) TYPE(DUMMY) TYPE(SMF) JOURNALNAME(char8) STREAMNAME(char26)

Conditions: ILLOGIC, INVREQ, LENGERR, NOTAUTH

94

CICS TS for z/OS: CICS Users Handbook

SPI syntax

CREATE LSRPOOL
CREATE LSRPOOL(data-value) ATTRIBUTES(data-value) ATTRLEN(data-value) LOGMESSAGE(cvda)

CREATE LSRPOOL attribute values:

DATA512(3-32767) DATA1K(3-32767) DATA2K(3-32767) DATA4K(3-32767) DATA8K(3-32767) DATA12K(3-32767) DATA16K(3-32767) DATA20K(3-32767) DATA24K(3-32767) DATA28K(3-32767) DATA32K(3-32767) DESCRIPTION(char58) HSDATA4K(0-16777215) HSDATA8K(0-16777215) HSDATA12K(0-16777215) HSDATA16K(0-16777215) HSDATA20K(0-16777215) HSDATA24K(0-16777215) HSDATA28K(0-16777215) HSDATA32K(0-16777215) HSINDEX4K(0-16777215) HSINDEX8K(0-16777215)

HSINDEX12K(0-16777215) HSINDEX16K(0-16777215) HSINDEX20K(0-16777215) HSINDEX24K(0-16777215) HSINDEX28K(0-16777215) HSINDEX32K(0-16777215) INDEX512(3-32767) INDEX1K(3-32767) INDEX2K(3-32767) INDEX4K(3-32767) INDEX8K(3-32767) INDEX12K(3-32767) INDEX16K(3-32767) INDEX20K(3-32767) INDEX24K(3-32767) INDEX28K(3-32767) INDEX32K(3-32767) LSRPOOLID(1) LSRPOOLID(1-8) MAXKEYLENGTH(0-255) SHARELIMIT(50) SHARELIMIT(1-100) STRINGS(1-255)

Conditions: ILLOGIC, INVREQ, LENGERR, NOTAUTH

Chapter 2. SPI command syntax

95

SPI syntax

CREATE MAPSET
CREATE MAPSET(data-value) ATTRIBUTES(data-value) ATTRLEN(data-value) LOGMESSAGE(cvda)

CREATE MAPSET attribute values:


RESIDENT(NO) DESCRIPTION(char58) USELPACOPY(NO) USELPACOPY(YES) RESIDENT(YES) STATUS(ENABLED) STATUS(DISABLED) USAGE(NORMAL) USAGE(TRANSIENT)

Conditions: ILLOGIC, INVREQ, LENGERR, NOTAUTH

CREATE PARTITIONSET
CREATE PARTITIONSET(data-value) ATTRIBUTES(data-value) ATTRLEN(data-value) LOGMESSAGE(cvda)

CREATE PARTITIONSET attribute values:


RESIDENT(NO) DESCRIPTION(char58) USELPACOPY(NO) USELPACPOY(YES) RESIDENT(YES) STATUS(ENABLED) STATUS(DISABLED) USAGE(NORMAL) USAGE(TRANSIENT)

Conditions: ILLOGIC, INVREQ, LENGERR, NOTAUTH

96

CICS TS for z/OS: CICS Users Handbook

SPI syntax

CREATE PARTNER
CREATE PARTNER(data-value) ATTRIBUTES(data-value) ATTRLEN(data-value) LOGMESSAGE(cvda)

CREATE PARTNER attribute values:


PROFILE(DFHCICSA) NETNAME(char8) DESCRIPTION(char58) TPNAME(char64) XTPNAME(hex128) NETWORK(char8) PROFILE(char8)

Conditions: ILLOGIC, INVREQ, LENGERR, NOTAUTH

CREATE PROCESSTYPE
CREATE PROCESSTYPE(data-value) ATTRIBUTES(data-value) ATTRLEN(data-value) LOGMESSAGE(cvda)

CREATE PROCESSTYPE attribute values:


AUDITLEVEL(OFF) FILE(char8) DESCRIPTION(char58) AUDITLOG(char8) AUDITLEVEL(ACTIVITY) AUDITLEVEL(FULL) AUDITLEVEL(PROCESS)

STATUS(ENABLED) STATUS(DISABLED)

Conditions: ILLOGIC, INVREQ, LENGERR, NOTAUTH

Chapter 2. SPI command syntax

97

SPI syntax

CREATE PROFILE
CREATE PROFILE(data-value) ATTRIBUTES(data-value) ATTRLEN(data-value) LOGMESSAGE(cvda)

CREATE PROFILE attribute values:


CHAINCONTROL(NO) CHAINCONTROL(YES) DESCRIPTION(char58) DVSUPRT(ALL) DVSUPRT(NONVTAM) DVSUPRT(VTAM) INBFMH(NO) INBFMH(ALL) INBFMH(DIP) INBFMH(EODS) MSGJRNL(NO) MSGJRNL(INOUT) MSGJRNL(INPUT) MSGJRNL(OUTPUT) RAQ(NO) RAQ(YES)

JOURNAL(NO) JOURNAL(1-99)

LOGREC(NO) LOGREC(YES) MODENAME(char8)

MSGINTEG(NO) MSGINTEG(YES)

NEPCLASS(0) NEPCLASS(0-255) RTIMOUT(NO) RTIMOUT(1-7000)

ONEWTE(NO) ONEWTE(YES)

PRINTERCOMP(NO) PRINTERCOMP(YES) UCTRAN(NO) UCTRAN(YES)

PROTECT(NO) PROTECT(YES)

SCRNSIZE(DEFAULT) SCRNSIZE(ALTERNATE)

Conditions: ILLOGIC, INVREQ, LENGERR, NOTAUTH

98

CICS TS for z/OS: CICS Users Handbook

SPI syntax

CREATE PROGRAM
CREATE PROGRAM(data-value) ATTRIBUTES(data-value) ATTRLEN(data-value) LOGMESSAGE(cvda)

CREATE PROGRAM attribute values:


CEDF(YES) CEDF(NO) EXECKEY(USER) EXECKEY(CICS) JVM(NO) JVM(YES) JVMPROFILE(char8) LANGUAGE(ASSEMBLER) LANGUAGE(C) LANGUAGE(COBOL) LANGUAGE(LE370) LANGUAGE(PLI) RESIDENT(NO) REMOTESYSTEM(char4) REMOTENAME(char8) USAGE(NORMAL) TRANSID(char4) USAGE(TRANSIENT) USELPACOPY(NO) USELPACOPY(YES) RESIDENT(YES) CONCURRENCY(QUASIRENT) CONCURRENCY(THREADSAFE) EXECUTIONSET(FULLAPI) EXECUTIONSET(DPLSUBSET) DATALOCATION(BELOW) DATALOCATION(ANY) HOTPOOL(NO) HOTPOOL(YES) JVMCLASS(char255) RELOAD(NO) RELOAD(YES) DESCRIPTION(char58)

STATUS(ENABLED) STATUS(DISABLED)

Conditions: ILLOGIC, INVREQ, LENGERR, NOTAUTH

Chapter 2. SPI command syntax

99

SPI syntax

CREATE REQUESTMODEL
CREATE REQUESTMODEL(data-value) ATTRIBUTES(data-value) ATTRLEN(data-value) LOGMESSAGE(cvda)

CREATE REQUESTMODEL attribute values:


TRANSID(CIRP) CORBASERVER(char4) DESCRIPTION(char58) TRANSID(char4) TYPE(EJB) TYPE(CORBA) TYPE(GENERIC)

BEANNAME(char240)

INTFACETYPE(BOTH) INTFACETYPE(HOME) INTFACETYPE(REMOTE)

INTERFACE(char255) MODULE(char255)

OPERATION(char255)

Conditions: ILLOGIC, INVREQ, LENGERR, NOTAUTH

100

CICS TS for z/OS: CICS Users Handbook

SPI syntax

CREATE SESSIONS
CREATE SESSIONS(data-value) ATTRIBUTES(data-value) ATTRLEN(data-value) LOGMESSAGE(cvda)

CREATE SESSIONS attribute values:


AUTOCONNECT(NO) AUTOCONNECT(ALL) AUTOCONNECT(YES) DISCREQ(NO) DISCREQ(YES) NEPCLASS(0) NEPCLASS(0-255) NETNAMEQ(char8) BUILDCHAIN(YES) CONNECTION(char4) BUILDCHAIN(NO) DESCRIPTION(char58)

IOAREALEN(0,0) IOAREALEN(0-32767,0-32767)

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

PROTOCOL(APPC) PROTOCOL(LU61) PROTOCOL(EXCI) RECEIVECOUNT(1-999)

RECEIVESIZE(4096) RECEIVEPFX(char2) RECEIVESIZE(1-30720)

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

RELREQ(NO) RELREQ(YES)

SENDSIZE(4096) SENDCOUNT(1-999) SESSPRIORITY(0) SESSPRIORITY(0-255) SENDPFX(char2) USERAREALEN(0) USERAREALEN(0-255) USERID(char8) SENDSIZE(1-30720) SESSNAME(char4)

Conditions: ILLOGIC, INVREQ, LENGERR, NOTAUTH

Chapter 2. SPI command syntax

101

SPI syntax

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

CREATE TCPIPSERVICE
CREATE TCPIPSERVICE(data-value) ATTRIBUTES(data-value) ATTRLEN(data-value) LOGMESSAGE(cvda)

CREATE TCPIPSERVICE attribute values:


BACKLOG(0) BACKLOG(1-32767) GRPCRITICAL(NO) PORTNUMBER(1-65535) GRPCRITICAL(YES) PROTOCOL(HTTP) PROTOCOL(IIOP) ATTACHSEC(VERIFY) PROTOCOL(ECI) ATTACHSEC(LOCAL) IPADDRESS(char15) SSL(NO) SSL(YES) SSL(CLIENTAUTH) STATUS(OPEN) STATUS(CLOSED) CERTIFICATE(char44) DESCRIPTION(char58) DNSGROUP(name)

| | | | |

TRANSACTION(CWXN) TRANSACTION(char4) TSQPREFIX(char6)

PROTOCOL(HTTP):
AUTHENTICATE(NO) PROTOCOL(HTTP) AUTHENTICATE(AUTOMATIC) AUTHENTICATE(AUTOREGISTER) AUTHENTICATE(BASIC) AUTHENTICATE(CERTIFICATE) URM(char8)

| | |
PROTOCOL(IIOP) AUTHENTICATE(CERTIFICATE)

PROTOCOL(IIOP):
AUTHENTICATE(NO) URM(char8)

| | | | Conditions: ILLOGIC, INVREQ, LENGERR, NOTAUTH

102

CICS TS for z/OS: CICS Users Handbook

SPI syntax

CREATE TDQUEUE
CREATE TDQUEUE(data-value) ATTRIBUTES(data-value) ATTRLEN(data-value) LOGMESSAGE(cvda)

Conditions: ILLOGIC, INVREQ, LENGERR, NOTAUTH

CREATE TDQUEUE attribute values for extra-partition queues:


BLOCKSIZE(0) TYPE(EXTRA) BLOCKFORMAT(BLOCKED) BLOCKFORMAT(UNBLOCKED) BLOCKSIZE(0-32767) DATABUFFERS(1-255) DATABUFFERS(1)

DISPOSITION(SHR) DDNAME(char8) DESCRIPTION(char58) DISPOSITION(OLD) DISPOSITION(MOD) DSNAME(DUMMY) DSNAME(char44)

ERROROPTION(IGNORE) ERROROPTION(SKIP)

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

RECORDSIZE(0) RECORDFORMAT(FIXED) RECORDFORMAT(VARIABLE) RECORDSIZE(0-32767) Remote attributes

SYSOUTCLASS(*) REWIND(LEAVE) REWIND(REREAD) SYSOUTCLASS(char1)

TYPEFILE(INPUT) TYPEFILE(OUTPUT) TYPEFILE(RDBACK)

CREATE TDQUEUE attribute values for intra-partition queues:


ATIFACILITY(TERMINAL) TYPE(INTRA) ATIFACILITY(FILE) ATIFACILITY(SYSTEM) RECOVSTATUS(NO) RECOVSTATUS(LOGICAL) RECOVSTATUS(PHYSICAL) TRIGGERLEVEL(1) TRIGGERLEVEL(0-32767) USERID(char8) Remote attributes TRANSID(char4) DESCRIPTION(char58) FACILITYID(char4)

WAIT(YES) WAIT(NO)

WAITACTION(REJECT) WAITACTION(QUEUE)

Chapter 2. SPI command syntax

103

SPI syntax

CREATE TDQUEUE attribute values for indirect queues:


TYPE(INDIRECT) DESCRIPTION(char58) INDIRECTNAME(char4) Remote attributes

CREATE TDQUEUE attribute values for remote queues of unspecified TYPE:

DESCRIPTION(char58)

Remote attributes

Remote attributes: # |
REMOTESYSTEM(char4) REMOTELENGTH(0-32767) REMOTENAME(char4) REMOTENAME(tdqueue)

104

CICS TS for z/OS: CICS Users Handbook

SPI syntax

CREATE TERMINAL
CREATE TERMINAL(data-value) ATTRIBUTES(data-value) ATTRLEN(data-value) COMPLETE DISCARD

CREATE TERMINAL attribute values:


ALTPRINTCOPY(NO) ALTPRINTCOPY(YES) ALTPRINTER(char4) ATTACHSEC(LOCAL) ATTACHSEC(IDENTIFY) ATTACHSEC(MIXIDPE) ATTACHSEC(PERSISTENT) ATTACHSEC(VERIFY) BINDSECURITY(NO) AUTINSTNAME(char8) BINDPASSWORD(hex16) BINDSECURITY(YES)

AUTINSTMODEL(NO) AUTINSTMODEL(ONLY) AUTINSTMODEL(YES) CONSOLE(NO) CONSOLE(0-250) CONSNAME(char8) DESCRIPTION(char58)

INSERVICE(YES) INSERVICE(NO) MODENAME(char8)

PRINTERCOPY(NO) NATLANG(E) NATLANG(K) NETNAME(char8) POOL(char8) PRINTER(char4) PRINTERCOPY(YES)

REMOTESYSNET(char8)

REMOTESYSTEM(char4) REMOTENAME(char4)

SECURITYNAME(char8)

SOLICITED(NO) SOLICITED(YES) TYPETERM(char8)

TASKLIMIT(NO) TASKLIMIT(1-32767)

TERMPRIORITY(0) TERMPRIORITY(0-255) TRANSACTION(char4)

USERID(char8)

Conditions: ILLOGIC, INVREQ, LENGERR, NOTAUTH

Chapter 2. SPI command syntax

105

SPI syntax

CREATE TRANCLASS
CREATE TRANCLASS(data-value) ATTRIBUTES(data-value) ATTRLEN(data-value) LOGMESSAGE(cvda)

CREATE TRANCLASS attribute values:


PURGETHRESH(NO) MAXACTIVE(0-999) DESCRIPTION(char58) PURGETHRESH(1-1000000)

Conditions: ILLOGIC, INVREQ, LENGERR, NOTAUTH

106

CICS TS for z/OS: CICS Users Handbook

SPI syntax

CREATE TRANSACTION
CREATE TRANSACTION(data-value) ATTRIBUTES(data-value) ATTRLEN(data-value) LOGMESSAGE(cvda)

CREATE TRANSACTION attribute values:


ACTION(BACKOUT) ACTION(COMMIT) ALIAS(char4) DTIMOUT(NO) DESCRIPTION(char58) INDOUBT(BACKOUT) INDOUBT(COMMIT) INDOUBT(WAIT) DTIMOUT(1-6800) ISOLATE(YES) ISOLATE(NO) BREXIT(char8) DUMP(YES) DUMP(NO) CMDSEC(NO) CMDSEC(YES) DYNAMIC(NO) DYNAMIC(YES) OTSTIMEOUT(NO) OTSTIMEOUT(1-240000) CONFDATA(NO) CONFDATA(YES)

LOCALQ(NO) LOCALQ(YES)

PRIORITY(1) PARTITIONSET(char8) PARTITIONSET(KEEP) PARTITIONSET(OWN) PRIORITY(0-255)

PROFILE(DFHCICST) PROFILE(char8)

RESSEC(NO) PROGRAM(char8) REMOTESYSTEM(char4) REMOTENAME(char8) RUNAWAY(SYSTEM) RUNAWAY(0-2700000) STORAGECLEAR(NO) STORAGECLEAR(YES) SHUTDOWN(DISABLED) SHUTDOWN(ENABLED) TASKDATAKEY(USER) TASKDATAKEY(CICS) SPURGE(NO) SPURGE(YES) RESSEC(YES)

RESTART(NO) RESTART(YES)

STATUS(ENABLED) STATUS(DISABLED)

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

TPURGE(NO) TPNAME(char64) XTPNAME(hex128) TRPROF(DFHCICSS) TRPROF(char8) TPURGE(YES)

TRACE(YES) TRACE(NO)

TRANCLASS(DFHTCL00) TRANCLASS(char8)

TWASIZE(0) TWASIZE(0-32767)

WAIT(YES) WAIT(NO)

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

XTRANID(hex8)

Conditions: ILLOGIC, INVREQ, LENGERR, NOTAUTH

Chapter 2. SPI command syntax

107

SPI syntax

CREATE TSMODEL
CREATE TSMODEL(data-value) ATTRIBUTES(data-value) ATTRLEN(data-value) LOGMESSAGE(cvda)

CREATE TSMODEL attribute values:


LOCATION(AUXILIARY) DESCRIPTION(char58) LOCATION(MAIN) POOLNAME(char8) PREFIX(char16) XPREFIX(char32) SECURITY(NO) REMOTESYSTEM(char4) REMOTEPREFIX(char16) XREMOTEPFX(char32) SECURITY(YES)

RECOVERY(NO) RECOVERY(YES)

Conditions: ILLOGIC, INVREQ, LENGERR, NOTAUTH

| | | | | |

CREATE TYPETERM
CREATE TYPETERM(data-value) ATTRIBUTES(data-value) ATTRLEN(data-value) LOGMESSAGE(cvda)

Conditions: ILLOGIC, INVREQ, LENGERR, NOTAUTH

108

CICS TS for z/OS: CICS Users Handbook

SPI syntax

CREATE TYPETERM attribute values (part 1 of 2):


ALTPAGE(0,0) ALTPAGE(0-255,0-255) APLTEXT(NO) APLTEXT(YES) ALTSCREEN(0-255,0-255) ATI(NO) ATI(YES) ALTSUFFIX(char1) APLKYBD(NO) APLKYBD(YES)

ASCII(NO) ASCII(7) ASCII(8) BACKTRANS(NO)

AUDIBLEALARM(NO) AUDIBLEALARM(YES)

AUTOCONNECT(NO) AUTOCONNECT(ALL) AUTOCONNECT(YES)

BRACKET(YES) BRACKET(NO)

BUILDCHAIN(NO) BUILDCHAIN(YES)

AUTOPAGE(NO) AUTOPAGE(YES) CGCSGID(0,0)

BACKTRANS(YES)

COLOR(NO) COLOR(YES)

COPY(NO) COPY(YES)

CREATESESS(NO) CREATESESS(YES) DISCREQ(YES)

CGCSGID(0-65535,0-65535) DEFSCREEN(0,0)

DEVICE(char8) DEFSCREEN(0-255,0-255) DUALCASEKYBD(NO) DUALCASEKYBD(YES) DESCRIPTION(char58) ERRCOLOR(NO) ERRCOLOR(BLUE) ERRCOLOR(GREEN) ERRCOLOR(NEUTRAL) ERRCOLOR(PINK) ERRCOLOR(RED) ERRCOLOR(TURQUOISE) ERRCOLOR(YELLOW) ERRLASTLINE(NO) ERRLASTLINE(YES) ERRHILIGHT(NO) ERRHILIGHT(BLINK) ERRHILIGHT(REVERSE) ERRHILIGHT(UNDERLINE) DISCREQ(NO)

ERRINTENSIFY(NO) ERRINTENSIFY(YES)

Chapter 2. SPI command syntax

109

SPI syntax

CREATE TYPETERM attribute values (part 2 of 2):


EXTENDEDDS(NO) EXTENDEDDS(YES) IOAREALEN(0,0) IOAREALEN(0-32767,0-32767) FMHPARM(NO) FMHPARM(YES) FORMFEED(NO) FORMFEED(YES) HILIGHT(NO) HILIGHT(YES) HORIZFORM(NO) HORIZFORM(YES)

KATAKANA(NO) KATAKANA(YES) LDCLIST(char8)

LIGHTPEN(NO) LIGHTPEN(YES)

LOGONMSG(NO) LOGMODE(char8) LOGMODE(0) OBFORMAT(NO) OBFORMAT(YES) PARTITIONS(NO) PARTITIONS(YES) LOGONMSG(YES)

MSRCONTROL(NO) MSRCONTROL(YES)

NEPCLASS(0) NEPCLASS(0-255)

OBOPERID(NO) OBOPERID(YES) PRINTADAPTER(NO)

OUTLINE(NO) OUTLINE(YES)

PAGESIZE(24,80) PAGESIZE(0-255,0-255) QUERY(NO) QUERY(ALL) QUERY(COLD)

PROGSYMBOLS(NO) PROGSYMBOLS(YES)

PRINTADAPTER(YES)

RECEIVESIZE(256) RECEIVESIZE(0-30720)

RECOVNOTIFY(NONE) RECOVNOTIFY(MESSAGE) RECOVNOTIFY(TRANSACTION)

RECOVOPTION(SYSDEFAULT) RECOVOPTION(CLEARCONV) RECOVOPTION(NONE) RECOVOPTION(RELEASESESS) RECOVOPTION(UNCONDREL) SENDSIZE(0) SENDSIZE(0-30720)

RELREQ(NO) RELREQ(YES) ROUTEDMSGS(ALL) ROUTEDMSGS(NONE) ROUTEDMSGS(SPECIFIC) SHIPPABLE(NO) SESSIONTYPE(char8) SHIPPABLE(YES)

RSTSIGNOFF(NOFORCE) RSTSIGNOFF(FORCE)

SIGNOFF(YES) SIGNOFF(NO) SIGNOFF(LOGOFF)

SOSI(NO) SOSI(YES)

TEXTKYBD(NO) TERMMODEL(1) TERMMODEL(2) USERAREALEN(0) USERAREALEN(0-255) TEXTKYBD(YES)

TEXTPRINT(NO) TEXTPRINT(YES)

TTI(YES) TTI(NO)

UCTRAN(NO) UCTRAN(TRANID) UCTRAN(YES)

VALIDATION(NO) VALIDATION(YES)

VERTICALFORM(NO) VERTICALFORM(YES)

110

CICS TS for z/OS: CICS Users Handbook

SPI syntax

| | | | | | | | |

DISABLE PROGRAM
DISABLE PROGRAM(data-value) ENTRYNAME(data-value) EXIT(data-value) EXITALL FORMATEDF

PURGEABLE

SHUTDOWN

SPI

STOP

TASKSTART

Conditions: INVEXITREQ, NOTAUTH

DISCARD AUTINSTMODEL
DISCARD AUTINSTMODEL(data-value)

Conditions: INVREQ, MODELIDERR, NOTAUTH

DISCARD CONNECTION
DISCON1

DISCON1
DISCARD CONNECTION(data-value)

Conditions: INVREQ, NOTAUTH, SYSIDERR

DISCARD CORBASERVER
DISCARD CORBASERVER(data-value)

Conditions: INVREQ,NOTAUTH, NOTFND

Chapter 2. SPI command syntax

111

SPI syntax

DISCARD DB2CONN
DISCARD DB2CONN

Conditions: INVREQ, NOTAUTH, NOTFND This command is threadsafe.

DISCARD DB2ENTRY
DISCARD DB2ENTRY(data-value)

Conditions: NOTFND, INVREQ, NOTAUTH This command is threadsafe.

DISCARD DB2TRAN
DISCARD DB2TRAN(data-value)

Conditions: NOTFND, NOTAUTH This command is threadsafe.

DISCARD DJAR
DISCARD DJAR(data-value)

Conditions: INVREQ,NOTAUTH, NOTFND

DISCARD DOCTEMPLATE
DISCARD DOCTEMPLATE(data-value)

Conditions: NOTAUTH, NOTFND

112

CICS TS for z/OS: CICS Users Handbook

SPI syntax

DISCARD ENQMODEL
DISCARD ENQMODEL(data-value)

Conditions: NOTAUTH, NOTFND

DISCARD FILE
DISCARD FILE(data-value)

Conditions: FILENOTFOUND, INVREQ, NOTAUTH

DISCARD JOURNALMODEL
DISCARD JOURNALMODEL(data-value)

Conditions: NOTAUTH, NOTFND

DISCARD JOURNALNAME
DISCARD DISCJ1

DISCJ1
JOURNALNAME(data-value)

Conditions: INVREQ, JIDERR, NOTAUTH

DISCARD PARTNER
DISCARD PARTNER(data-value)

Conditions: INVREQ, NOTAUTH, PARTNERIDERR

Chapter 2. SPI command syntax

113

SPI syntax

DISCARD PROCESSTYPE
DISCARD PROCESSTYPE(data-value)

Conditions: INVREQ, NOTAUTH, PROCESSERR

DISCARD PROFILE
DISCARD PROFILE(data-value)

Conditions: INVREQ, NOTAUTH, PROFILEIDERR

DISCARD PROGRAM
DISCARD PROGRAM(data-value)

Conditions: INVREQ, NOTAUTH, PGMIDERR

DISCARD REQUESTMODEL
DISCARD DISCRM1

DISCRM1
REQUESTMODEL(data-value)

Conditions: NOTAUTH, NOTFND

DISCARD TCPIPSERVICE
DISCARD TCPIPSERVICE(data-value)

Conditions: INVREQ, NOTAUTH, NOTFND

114

CICS TS for z/OS: CICS Users Handbook

SPI syntax

DISCARD TDQUEUE
DISTDQ1

DISTDQ1
DISCARD TDQUEUE(data-value)

Conditions: INVREQ, NOTAUTH, QIDERR

DISCARD TERMINAL
DISTER1

DISTER1
DISCARD TERMINAL(data-value)

Conditions: INVREQ, NOTAUTH, TERMIDERR

DISCARD TRANCLASS
DIS1

DIS1
DISCARD TRANCLASS(data-value)

Conditions: INVREQ, NOTAUTH, TCIDERR

DISCARD TRANSACTION
DISCARD TRANSACTION(data-value)

Conditions: INVREQ, NOTAUTH, TRANSIDERR

Chapter 2. SPI command syntax

115

SPI syntax

DISCARD TSMODEL
DISCARD TSMODEL(data-value)

Conditions: INVREQ, NOTAUTH, NOTFND

| |

ENABLE PROGRAM

ENABLE PROGRAM(data-value) ENTRY(ptr-ref) ENTRYNAME(data-value) EXIT(data-value) FORMATEDF GALENGTH(data-value) GAENTRYNAME(data-value) INDOUBTWAIT LINKEDITMODE QUASIRENT THREADSAFE OPENAPI OPENAPI PURGEABLE SHUTDOWN SPI START TALENGTH(data-value) TASKSTART

| | | | Conditions: INVEXITREQ, NOTAUTH

EXTRACT EXIT
EXTRACT EXIT PROGRAM(data-value) ENTRYNAME(data-value) GASET(ptr-ref) GALENGTH(data-area)

Conditions: INVEXITREQ, NOTAUTH

116

CICS TS for z/OS: CICS Users Handbook

SPI syntax

INQUIRE AUTINSTMODEL
INQUIRE AUTINSTMODEL(data-value)

Conditions: END, ILLOGIC, MODELIDERR, NOTAUTH

| |

INQUIRE AUTOINSTALL

INQUIRE AUTOINSTALL AIBRIDGE(cvda) CONSOLES(cvda) CURREQS(data-area) ENABLESTATUS(cvda) MAXREQS(data-area) PROGRAM(data-area)

| | | | Conditions: NOTAUTH

INQUIRE BEAN
INQUIRE BEAN(data-value) CORBASERVER(data-area) DJAR(data-area)

Conditions: END, NOTAUTH , NOTFND

Chapter 2. SPI command syntax

117

SPI syntax

INQUIRE BRFACILITY

INQUIRE BRFACILITY(data-value) KEEPTIME(data-area) LINKSYSTEM(data-area) LINKSYSNET(data-area) NAMESPACE(cvda) NETNAME(data-area) REMOTESYSNET(data-area) REMOTESYSTEM(data-area) TASKID(data-area) TERMID(data-area) TERMSTATUS(cvda) TRANSACTION(data-area) USERID(data-area)

Conditions: END, ILLOGIC, NOTAUTH, NOTFOUND

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

Conditions: END, ILLOGIC, NOTAUTH, POOLERR

118

CICS TS for z/OS: CICS Users Handbook

SPI syntax

INQUIRE CONNECTION

INQUIRE CONNECTION(data-value) ACCESSMETHOD(cvda) ACQSTATUS(cvda) AUTOCONNECT(cvda) CONNSTATUS(cvda) CONNTYPE(cvda) CQP(cvda) EXITTRACING(cvda) GRNAME(data-area) LINKSYSTEM(data-area) MEMBERNAME(data-area) NETNAME(data-area) NQNAME(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

INQUIRE CORBASERVER

INQUIRE CORBASERVER(data-value) AUTOPUBLISH(cvda) CERTIFICATE(data-area) CLIENTCERT(data-area) DJARDIR(data-area) HOST(data-area) JNDIPREFIX(data-area) SESSBEANTIME(data-area) SHELF(data-area) SSLUNAUTH(data-area) STATE(cvda) UNAUTH(data-area)

Conditions: END, NOTAUTH, NOTFND

Chapter 2. SPI command syntax

119

SPI syntax

| |

INQUIRE DB2CONN

INQUIRE DB2CONN

ACCOUNTREC(cvda) AUTHID(data-area) AUTHTYPE(cvda) COMAUTHID(data-area) COMAUTHTYPE(cvda) COMTHREADLIM(data-area) COMTHREADS(data-area) CONNECTERROR(cvda) CONNECTST(cvda) DB2GROUPID(data-area) DB2ID(data-area) DB2RELEASE(data-area) DROLLBACK(cvda) MSGQUEUE1(data-area) MSGQUEUE2(data-area) MSGQUEUE3(data-area) NONTERMREL(cvda) PLAN(data-area) PLANEXITNAME(data-area) PRIORITY(cvda) PURGECYCLEM(data-area) PURGECYCLES(data-area) RESYNCMEMBER(cvda) SIGNID(data-area) STANDBYMODE(cvda) STATSQUEUE(data-area) TCBLIMIT(data-area) TCBs(data-area) THREADS(data-area) THREADERROR(cvda) THREADLIMIT(data-area) THREADWAIT(cvda)

| | | | | Conditions: NOTAUTH, NOTFND This command is threadsafe.

120

CICS TS for z/OS: CICS Users Handbook

SPI syntax

INQUIRE DB2ENTRY
INQUIRE DB2ENTRY(data-value) ACCOUNTREC(cvda) AUTHID(data-area) DISABLEDACT(cvda) DROLLBACK(cvda) ENABLESTATUS(cvda) PLAN(data-area) PRIORITY(cvda) PLANEXITNAME(data-area) PROTECTNUM(data-area) THREADWAIT(cvda) THREADLIMIT(data-area) THREADS(data-area) PTHREADS(data-area) AUTHTYPE(cvda)

Conditions: END,ILLOGIC,NOTAUTH, NOTFND This command is threadsafe.

INQUIRE DB2TRAN
INQUIRE DB2TRAN (data-value) DB2ENTRY(data-area) PLAN(data-area)

PLANEXITNAME(data-area)

TRANSID(data-area)

Conditions: END,ILLOGIC,NOTAUTH, NOTFND This command is threadsafe.

Chapter 2. SPI command syntax

121

SPI syntax

INQUIRE DELETSHIPPED
INQUIRE DELETSHIPPED IDLE(data-area) IDLEHRS(data-area) IDLEMINS(data-area) IDLESECS(data-area)

INTERVAL(data-area) hours minutes

seconds

hours:
INTERVALHRS(data-area)

minutes:
INTERVALMINS(data-area)

seconds:
INTERVALSECS(data-area)

Conditions: NOTAUTH

INQUIRE DISPATCHER

INQUIRE DISPATCHER ACTHPTCBS(data-area) ACTJVMTCBS(data-area) ACTOPENTCBS(data-area) MAXHPTCBS(data-area) MAXJVMTCBS(data-area) MAXOPENTCBS(data-area) MROBATCH(data-area) PRTYAGING(data-area) RUNAWAY(data-area) SCANDELAY(data-area) SUBTASKS(data-area) TIME(data-area)

Conditions: NOTAUTH

122

CICS TS for z/OS: CICS Users Handbook

SPI syntax

INQUIRE DJAR

INQUIRE

DJAR(data-value) CORBASERVER(data-area) HFSFILE(data-area) LASTMODTIME(data-area) STATE(cvda)

Conditions: NOTAUTH, NOTFND

INQUIRE DOCTEMPLATE

INQUIRE DOCTEMPLATE(data-value) APPENDCRLF(cvda) DDNAME(data-area) DSNAME(data-area) EXITPGM(data-area) FILE(data-area) MEMBER(data-area) PROGRAM(data-area) TDQUEUE(data-area) TEMPLATENAME(data-area) TEMPLATETYPE(cvda) TSQUEUE(data-area) TYPE(cvda)

Conditions: END, ILLOGIC, NOTFND, NOTAUTH

Chapter 2. SPI command syntax

123

SPI syntax

INQUIRE DSNAME

INQUIRE DSNAME(data-value) ACCESSMETHOD(cvda) AVAILABILITY(cvda) BACKUPTYPE(cvda) BASEDSNAME(data-area) FILECOUNT(data-area) FWDRECOVLOG(data-area) FWDRECOVLSN(data-area) OBJECT(cvda) LOSTLOCKS(cvda) QUIESCESTATE(cvda) RECOVSTATUS(cvda) RETLOCKS(cvda) VALIDITY(cvda)

Conditions: DSNNOTFOUND, END, ILLOGIC, IOERR, NOTAUTH

INQUIRE DUMPDS

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

Conditions: NOTAUTH

124

CICS TS for z/OS: CICS Users Handbook

SPI syntax

INQUIRE ENQ

INQUIRE ENQ

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

DURATION(data-area) ENQFAILS(data-area) NETUOWID(data-area) QUALIFIER(data-area) QUALLEN(data-area) RELATION(cvda) RESLEN(data-area) RESOURCE(data-area) STATE(cvda) TASKID(data-area) TRANSID(data-area) TYPE(cvda) UOW(data-area)

Conditions: END, ILLOGIC, NOTAUTH, UOWNOTFOUND

INQUIRE ENQMODEL

INQUIRE ENQMODEL(data-value) ENQSCOPE(data-area) ENQNAME(data-area) STATUS(cvda)

Conditions: END, ILLOGIC, NOTAUTH, NOTFND

INQUIRE EXCI |
INQUIRE EXCI(data-area) TASK(data-area) URID(data-area)

Conditions: END, ILLOGIC, NOTAUTH

Chapter 2. SPI command syntax

125

SPI syntax

| # |

INQUIRE EXITPROGRAM

INQUIRE EXITPROGRAM(data-value) EXIT(data-value) ENTRYNAME(data-area) APIST(data-value) CONCURRENTST(data-value) CONNECTST(cvda) ENTRY(ptr-ref) FORMATEDFST(cvda) GAENTRYNAME(data-area) GALENGTH(data-area) GAUSECOUNT(data-area) INDOUBTST(cvda) NUMEXITS(data-area) PURGEABLEST(cvda) QUALIFIER(data-area) SHUTDOWNST(cvda) SPIST(cvda) STARTSTATUS(cvda) TALENGTH(data-area) TASKSTARTST(cvda) USECOUNT(data-area)

# # # # # Conditions: END, ILLOGIC, INVREQ, NOTAUTH, PGMIDERR This command is threadsafe.

126

CICS TS for z/OS: CICS Users Handbook

SPI syntax

INQUIRE FILE

INQUIRE FILE(data-value) ACCESSMETHOD(cvda) ADD(cvda) BASEDSNAME(data-area) BLOCKFORMAT(cvda) BLOCKKEYLEN(data-area) BLOCKSIZE(data-area) BROWSE(cvda) CFDTPOOL(data-area) DELETE(cvda) DISPOSITION(cvda) DSNAME(data-area) EMPTYSTATUS(cvda) ENABLESTATUS(cvda) EXCLUSIVE(cvda) FWDRECSTATUS(cvda) JOURNALNUM(data-area) KEYLENGTH(data-area) KEYPOSITION(data-area) LOADTYPE(cvda) LSRPOOLID(data-area) MAXNUMRECS(data-area) OBJECT(cvda) OPENSTATUS(cvda) READ(cvda) READINTEG(cvda) RECORDFORMAT(cvda) RECORDSIZE(data-area) RECOVSTATUS(cvda) RELTYPE(cvda) REMOTENAME(data-area) REMOTESYSTEM(data-area) REMOTETABLE(cvda) RLSACCESS(cvda) STRINGS(data-area) TABLE(cvda) TABLENAME(data-area) TYPE(cvda) UPDATE(cvda) UPDATEMODEL(cvda)

Conditions: END, FILENOTFOUND, ILLOGIC, NOTAUTH

Chapter 2. SPI command syntax

127

SPI syntax

INQUIRE IRC
INQUIRE IRC OPENSTATUS(cvda)

Conditions: NOTAUTH

INQUIRE JOURNALMODEL
INQL1 INQL2 INQL4 INQL3

INQL1
INQUIRE JOURNALMODEL(data-value)

INQL2
JOURNALNAME(data-area)

INQL4
STREAMNAME(data-area)

INQL3
TYPE(cvda)

Conditions: END, ILLOGIC, NOTAUTH, NOTFND

INQUIRE JOURNALNAME

INQUIRE JOURNALNAME(data-value) STATUS(cvda) STREAMNAME(data-area) TYPE(cvda)

Conditions: END, ILLOGIC, JIDERR, NOTAUTH

128

CICS TS for z/OS: CICS Users Handbook

SPI syntax

INQUIRE JVMPOOL
INQUIRE JVMPOOL TOTAL(data-area) PHASEOUT(data-area) STATUS(data-area)

Conditions: INVREQ, NOTAUTH

INQUIRE MODENAME

INQUIRE MODENAME(data-value) CONNECTION(data-value) ACTIVE(data-area) AUTOCONNECT(cvda) AVAILABLE(data-area) MAXIMUM(data-area) MAXWINNERS(data-area)

Conditions: END, ILLOGIC, NOTAUTH, SYSIDERR

Chapter 2. SPI command syntax

129

SPI syntax

INQUIRE MONITOR #
INQUIRE MONITOR APPLNAMEST(cvda) CONVERSEST(cvda) EXCEPTCLASS(cvda) FILELIMIT(data-area) FREQUENCY(data-area) hours minutes PERFCLASS(cvda) RMIST(cvda) STATUS(cvda) SUBSYSTEMID(data-area) SYNCPOINTST(cvda) TIME(cvda) TSQUEUELIMIT(data-area)

seconds

hours:
FREQUENCYHRS(data-area)

minutes:
FREQUENCYMINS(data-area)

seconds:
FREQUENCYSECS(data-area)

Conditions: NOTAUTH

INQUIRE NETNAME/TERMINAL
INQUIRE NETNAME(data-value) TERMINAL(data-area) options

options:
for options, see INQUIRE TERMINAL

Conditions: NOTAUTH, TERMIDERR

130

CICS TS for z/OS: CICS Users Handbook

SPI syntax

INQUIRE PARTNER

INQUIRE PARTNER(data-value) NETWORK(data-area) NETNAME(data-area) PROFILE(data-area) TPNAME(data-area) TPNAMELEN(data-area)

Conditions: END, ILLOGIC, NOTAUTH, PARTNERIDERR

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

AUDITLEVEL(cvda)

STATUS(cvda)

Conditions: NOTAUTH, PROCESSERR

INQUIRE PROFILE
INQUIRE PROFILE(data-value)

Conditions: END, ILLOGIC, NOTAUTH, PROFILEIDERR

Chapter 2. SPI command syntax

131

SPI syntax

INQUIRE PROGRAM

INQUIRE PROGRAM(data-value) CEDFSTATUS(cvda) COBOLTYPE(cvda) COPY(cvda) CONCURRENCY(cvda) DATALOCATION(cvda) DYNAMSTATUS(cvda) ENTRYPOINT(ptr-ref) EXECKEY(cvda) EXECUTIONSET(cvda) HOLDSTATUS(cvda) HOTPOOLING(cvda) JVMCLASS(data-area) JVMDEBUG(cvda) JVMPROFILE(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 TS for z/OS: CICS Users Handbook

SPI syntax

INQUIRE REQID
INQUIRE REQID(data-value) REQTYPE(cvda) TERMID(data-area) TRANSID(data-area)

INTERVAL(data-area) TIME(data-area) AFTER hours minutes AT hours minutes

seconds seconds

SET(ptr-ref) LENGTH(data-area) FMHSTATUS(cvda)

RTRANSID(data-area)

RTERMID(data-area)

QUEUE(data-area)

USERID(data-area)

hours:
HOURS(data-area)

minutes:
MINUTES(data-area)

seconds:
SECONDS(data-area)

Conditions: END, ILLOGIC, INVREQ, NOTAUTH, NOTFND

INQUIRE REQUESTMODEL

INQUIRE REQUESTMODEL(data-value) BEANNAME(data-area) CORBASERVER(data-area) INTERFACE(data-area) INTFACETYPE(cvda) MODULE(data-area) OPERATION(data-area) TRANSID(data-value) TYPE(cvda)

Conditions: END, ILLOGIC, NOTAUTH

Chapter 2. SPI command syntax

133

SPI syntax

INQUIRE RRMS
INQUIRE RRMS OPENSTATUS(cvda)

Conditions: NOTAUTH

INQUIRE STATISTICS
INQUIRE STATISTICS end time int time next time

RECORDING(cvda)

end time:
ENDOFDAY(data-area) ENDOFDAYHRS(data-area)

end of day mins,secs

end of day mins,secs:


ENDOFDAYMINS(data-area) ENDOFDAYSECS(data-area)

int time:
INTERVAL(data-area) INTERVALHRS(data-area)

interval mins,secs

interval mins,secs:
INTERVALMINS(data-area) INTERVALSECS(data-area)

next time:
NEXTTIME(data-area) NEXTTIMEHRS(data-area)

next time mins,secs

next time mins,secs:


NEXTTIMEMINS(data-area) NEXTTIMESECS(data-area)

Conditions: NOTAUTH

134

CICS TS for z/OS: CICS Users Handbook

SPI syntax

INQUIRE STORAGE
INQUIRE STORAGE ADDRESS(ptr-value) nlist elist Element llist Flength task

Element:
ELEMENT(ptr-ref)

Flength:
FLENGTH(data-area)

nlist:
NUMELEMENTS(data-area)

elist:

ELEMENTLIST(ptr-ref)

llist:

LENGTHLIST(ptr-ref)

task:

TASK(data-value)

Conditions: NOTAUTH, TASKIDERR

INQUIRE STREAMNAME

INQUIRE STREAMNAME(data-value) STATUS(cvda) SYSTEMLOG(cvda) USECOUNT(data-area)

Conditions: END, ILLOGIC, NOTAUTH, NOTFND

Chapter 2. SPI command syntax

135

SPI syntax

INQUIRE SYSDUMPCODE

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

Conditions: END, ILLOGIC, NOTAUTH, NOTFND

136

CICS TS for z/OS: CICS Users Handbook

SPI syntax

INQUIRE SYSTEM

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

Condition: NOTAUTH

Chapter 2. SPI command syntax

137

SPI syntax

| |

INQUIRE TASK

INQUIRE TASK(data-value) options

| | | | | Conditions: NOTAUTH, TASKIDERR This command is threadsafe.

138

CICS TS for z/OS: CICS Users Handbook

SPI syntax

| |

options:

ACTIVITY(data-area) ACTIVITYID(data-area) ATTACHTIME(data-area) BRFACILITY(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)

| | |

Chapter 2. SPI command syntax

139

SPI syntax

INQUIRE TASK LIST


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

SET(ptr-ref) SETTRANSID(ptr-ref)

Condition: NOTAUTH

INQUIRE TCLASS

INQUIRE TCLASS(data-value) CURRENT(data-area) MAXIMUM(data-area)

Conditions: NOTAUTH, TCIDERR

INQUIRE TCPIP
INQUIRE TCPIP ACTSOCKETS(data-value) MAXSOCKETS(data-value) OPENSTATUS(cvda)

Conditions: INVREQ, NOTAUTH

140

CICS TS for z/OS: CICS Users Handbook

SPI syntax

| |

INQUIRE TCPIPSERVICE

INQUIRE TCPIPSERVICE(data-value) ATTACHSEC(cvda) AUTHENTICATE(cvda) BACKLOG(data-area) CERTIFICATE(data-area) CLOSETIMEOUT(data-area) CONNECTIONS(data-area) DNSGROUP(data-area) DNSSTATUS(cvda) GRPCRITICAL(cvda) IPADDRESS(data-area) OPENSTATUS(cvda) PORT(data-area) PROTOCOL(cvda) SOCKETCLOSE(cvda) SSLTYPE(cvda) TRANSID(data-area) TSQPREFIX(data-area) URM(data-area)

| | | | Conditions: INVREQ, NOTAUTH , NOTFND

Chapter 2. SPI command syntax

141

SPI syntax

INQUIRE TDQUEUE

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

Conditions: ENDCOND, ILLOGIC, NORMAL, NOTAUTH, QIDERR

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

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

142

CICS TS for z/OS: CICS Users Handbook

SPI syntax

INQUIRE TERMINAL

ACCESSMETHOD(cvda) ACQSTATUS(cvda) ALTPAGEHT(data-area) ALTPAGEWD(data-area) ALTPRINTER(data-area) ALTPRTCOPYST(cvda) ALTSCRNHT(data-area) ALTSCRNWD(data-area) ALTSUFFIX(data-area) APLKYBDST(cvda) APLTEXTST(cvda) ASCII(cvda) ATISTATUS(cvda) AUDALARMST(cvda) AUTOCONNECT(cvda) BACKTRANSST(cvda) COLORST(cvda) CONSOLE(data-area) COPYST(cvda) CORRELID(data-area) CREATESESS(cvda) DATASTREAM(cvda) DEFPAGEHT(data-area) DEFPAGEWD(data-area) DEFSCRNHT(data-area) DEFSCRNWD(data-area) DEVICE(cvda) DISCREQST(cvda) DUALCASEST(cvda) EXITTRACING(cvda) EXTENDEDDSST(cvda) FMHPARMST(cvda) FORMFEEDST(cvda) GCHARS(data-area) GCODES(data-area) HFORMST(cvda) HILIGHTST(cvda) KATAKANAST(cvda) LIGHTPENST(cvda) LINKSYSTEM(data-area) MAPNAME(data-area) MAPSETNAME(data-area) MODENAME(data-area) MSRCONTROLST(cvda) NATLANG(data-area)

NATURE(cvda) NEXTTRANSID(data-area) NQNAME(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

143

SPI syntax

INQUIRE TRACEDEST

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

Conditions: NOTAUTH

INQUIRE TRACEFLAG

INQUIRE TRACEFLAG SINGLESTATUS(cvda) SYSTEMSTATUS(cvda) TCEXITSTATUS(cvda) USERSTATUS(cvda)

Conditions: NOTAUTH

INQUIRE TRACETYPE

INQUIRE TRACETYPE

STANDARD SPECIAL

COMPID(data-area)

Conditions: NOTAUTH, NOTFND

144

CICS TS for z/OS: CICS Users Handbook

SPI syntax

INQUIRE TRANCLASS

INQUIRE TRANCLASS(data-value) ACTIVE(data-area) MAXACTIVE(data-area) PURGETHRESH(data-area) QUEUED(data-area)

Conditions: INVREQ, NOTAUTH, TCIDERR

INQUIRE TRANDUMPCODE

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

Conditions: END, ILLOGIC, NOTAUTH, NOTFND

Chapter 2. SPI command syntax

145

SPI syntax

INQUIRE TRANSACTION

INQUIRE TRANSACTION(data-value) BREXIT(data-area) CMDSEC(cvda) DTIMEOUT(data-area) DUMPING(cvda) FACILITYLIKE(data-area) INDOUBT(cvda) INDOUBTMINS(data-area) INDOUBTWAIT(cvda) ISOLATEST(cvda) PRIORITY(data-area) OTSTIMEOUT(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

146

CICS TS for z/OS: CICS Users Handbook

SPI syntax

INQUIRE TSMODEL

INQUIRE

TSMODEL(data-value) LOCATION(cvda) POOLNAME(data-area) PREFIX(data-area) RECOVSTATUS(cvda) REMOTEPREFIX(data-area) REMOTESYSTEM(data-area) SECURITYST(cvda)

Conditions: END, ILLOGIC, NOTAUTH, NOTFND

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

Conditions: END, ILLOGIC, NOTAUTH, NOTFND

INQUIRE TSQUEUE

INQUIRE

TSQUEUE(data-value) TSQNAME(data-value)

POOLNAME(data-value) SYSID(data-value)

FLENGTH(data-area) LASTUSEDINT(data-area) LOCATION(cvda) MAXITEMLEN(data-area) MINITEMLEN(data-area) NUMITEMS(data-area) RECOVSTATUS(cvda) TRANSID(data-area)

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

Chapter 2. SPI command syntax

147

SPI syntax

INQUIRE UOW

INQUIRE UOW(data-area) AGE(data-area) LINK(data-area) NETNAME(data-area) NETUOWID(data-area) OTSTID(data-area) SYSID(data-area) TASKID(data-area) TERMID(data-area) TRANSID(data-area) UOWSTATE(cvda) USERID(data-area) WAITCAUSE(cvda) WAITSTATE(cvda)

Conditions: END, ILLOGIC, NOTAUTH, UOWNOTFOUND

INQUIRE UOWDSNFAIL
INQUIRE UOWDSNFAIL CAUSE(cvda) DSNAME(data-area) NETNAME(data-area) UOW(data-area) REASON(cvda) RLSACCESS(cvda) SYSID(data-area)

Conditions: END, ILLOGIC, NOTAUTH

148

CICS TS for z/OS: CICS Users Handbook

SPI syntax

INQUIRE UOWENQ

INQUIRE UOWENQ ENQSCOPE(data-value) RESOURCE(data-value) RESLEN(data-value) UOW(data-value) DURATION(data-area) ENQFAILS(data-area) NETUOWID(data-area) QUALIFIER(data-area) QUALLEN(data-area) RELATION(cvda) RESLEN(data-area) RESOURCE(data-area) STATE(cvda) TASKID(data-area) TRANSID(data-area) TYPE(cvda) UOW(data-area)

Conditions: END, ILLOGIC, NOTAUTH, UOWNOTFOUND

INQUIRE UOWLINK

INQUIRE UOWLINK(data-area)

HOST(data-area) LINK(data-area) NETUOWID(data-area) PROTOCOL(cvda) RESYNCSTATUS(cvda) RMIQFY(data-area) ROLE(cvda) SYSID(data-area) TYPE(cvda) UOW(data-area) URID(data-area)

Conditions: END, ILLOGIC, NOTAUTH, UOWLNOTFOUND, UOWNOTFOUND

Chapter 2. SPI command syntax

149

SPI syntax

INQUIRE VTAM

INQUIRE VTAM GRNAME(data-area) GRSTATUS(cvda) OPENSTATUS(cvda) PSDINTERVAL(data-area) hours minutes

seconds

hours:
PSDINTHRS(data-area)

minutes:
PSDINTMINS(data-area)

seconds:
PSDINTSECS(data-area)

Conditions: INVREQ, NOTAUTH

INQUIRE WEB

INQUIRE WEB(data-area) GARBAGEINT(data-area) TIMEOUTINT(data-area)

Conditions: NOTAUTH

| |

PERFORM CORBASERVER
PERFORM CORBASERVER(data-value) ACTION(cvda) PUBLISH RETRACT SCAN

| | # # Conditions: DUPRES, INVREQ, NOTAUTH, NOTFND

150

CICS TS for z/OS: CICS Users Handbook

SPI syntax

PERFORM DELETSHIPPED
PERFORM DELETSHIPPED

Conditions: NOTAUTH

PERFORM DJAR
PERFORM DJAR(data-value) ACTION(cvda) PUBLISH RETRACT

Conditions: INVREQ, NOTAUTH, NOTFND

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

CALLER(data-value) CALLERLENGTH(data-value)

DUMPID(data-area)

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

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

Conditions: INVREQ

PERFORM RESETTIME
PERFORM RESETTIME

Conditions: INVREQ, NOTAUTH

Chapter 2. SPI command syntax

151

SPI syntax

PERFORM SECURITY REBUILD


PERFORM SECURITY REBUILD ESMRESP(data-area)

Conditions: INVREQ, IOERR, NORMAL, NOTAUTH, SYSBUSY

PERFORM SHUTDOWN
PERFORM SHUTDOWN IMMEDIATE NORESTART NORESTART

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

Conditions: INVREQ, NOTAUTH, TRANSIDERR

152

CICS TS for z/OS: CICS Users Handbook

SPI syntax

| |

PERFORM STATISTICS RECORD

PERFORM STATISTICS RECORD ALL RESETNOW AUTOINSTALL CONNECTION CORBASERVER DB2 DISPATCHER ENQUEUE FEPI FILE JOURNALNAME JOURNALNUM JVMPOOL LSRPOOL MONITOR PROGAUTO PROGRAM RECOVERY REQUESTMODEL STATS STORAGE STREAMNAME SYSDUMP TABLEMGR TCPIP TCPIPSERVICE TDQUEUE TERMINAL TRANCLASS TCLASS TRANDUMP TRANSACTION TSQUEUE VTAM

| | | | Conditions: IOERR, NOTAUTH, NOTFND

Chapter 2. SPI command syntax

153

SPI syntax

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

IDLIST(data-value) IDLISTLENGTH(data-value)

PARTIAL

Conditions: NOTAUTH

| | | | | | | | |

SET AUTOINSTALL
SET AUTOINSTALL AIBRIDGE(cvda) CONSOLES(cvda) MAXREQS(data-value)

PROGRAM(data-value)

Conditions: INVREQ, NOTAUTH, PGMIDERR

SET BRFACILITY # |
SET BRFACILITY ( data-area ) TERMSTATUS(cvda) RELEASED

Conditions: NOTAUTH, NOTFOUND

154

CICS TS for z/OS: CICS Users Handbook

SPI syntax

SET CONNECTION
SET CONNECTION(data-value) ACQSTATUS(cvda) CONNSTATUS(cvda) ACQUIRED RELEASED AFFINITY(cvda) ENDAFFINITY EXITTRACING(cvda) EXITTRACE NOEXITTRACE

PENDSTATUS(cvda) NOTPENDING

PURGETYPE(cvda) CANCEL FORCECANCEL FORCEPURGE KILL PURGE

RECOVSTATUS(cvda) NORECOVDATA

SERVSTATUS(cvda) INSERVICE OUTSERVICE

UOWACTION(cvda) BACKOUT COMMIT FORCE RESYNC

ZCPTRACING(cvda) NOZCPTRACE ZCPTRACE

Conditions: INVREQ, IOERR, NORMAL, NOTAUTH, SYSIDERR

| |

SET CORBASERVER
SET CORBASERVER(data-value) AUTOPUBLISH(cvda) AUTOPUB NOAUTO SESSBEANTIME(data-value)

| | | | Conditions: INVREQ, NOTAUTH, NOTFND

Chapter 2. SPI command syntax

155

SPI syntax

| |

SET DB2CONN

SET DB2CONN ACCOUNTREC(cvda) UOW TASK TXID NONE AUTHID(data-area) AUTHTYPE(cvda) GROUP SIGN TERM TX OPID USERID BUSY(cvda) WAIT NOWAIT FORCE COMAUTHID(data-area) COMAUTHTYPE(cvda) CGROUP CSIGN CTERM CTX COPID CUSERID COMTHREADLIM(data-area) CONNECTERROR(cvda) ABEND SQLCODE CONNECTST(cvda) CONNECTED NOTCONNECTED DB2GROUPID(data-area) DB2ID(data-area) MSGQUEUE1(data-area) MSGQUEUE2(data-area) MSGQUEUE3(data-area) NONTERMREL(cvda) RELEASE NORELEASE PLAN(data-area) PLANEXITNAME(data-area) PRIORITY(cvda) HIGH EQUAL LOW PURGECYCLEM(data-area) PURGECYCLES(data-area) RESYNCMEMBER(cvda) RESYNC NORESYNC SECURITY(REBUILD) SIGNID(data-area) STANDBYMODE(cvda) NOCONNECT CONNECT RECONNECT STATSQUEUE(data-area) TCBLIMIT(data-area) THREADLIMIT(data-area) THREADWAIT(cvda) TWAIT NOTWAIT

| | | | | Conditions: NORMAL, NOTAUTH, NOTFND, INVREQ This command is threadsafe.

156

CICS TS for z/OS: CICS Users Handbook

SPI syntax

SET DB2ENTRY

SET DB2ENTRY (data-area) ACCOUNTREC(cvda) UOW TASK TXID NONE AUTHID(data-area) AUTHTYPE(cvda) GROUP SIGN TERM TX OPID USERID BUSY(cvda) WAIT NOWAIT FORCE DISABLEDACT(cvda) ABEND SQLCODE POOL ENABLESTATUS(cvda) ENABLED DISABLED PLAN(data-area) PLANEXITNAME(data-area) PRIORITY(cvda) HIGH EQUAL LOW PROTECTNUM(data-area) THREADLIMIT(data-area) THREADWAIT(cvda) TWAIT NOWAIT TPOOL

Conditions: NOTAUTH, NOTFND, INVREQ This command is threadsafe.

Chapter 2. SPI command syntax

157

SPI syntax

SET DB2TRAN

SET DB2TRAN DB2ENTRY(data-area) TRANSID(data-area)

Conditions: NOTAUTH, NOTFND, INVREQ This command is threadsafe.

SET DELETSHIPPED
SET DELETSHIPPED IDLE(data-value) INTERVAL(data-value)

IDLEHRS(data-value) IDLEMINS(data-value) IDLESECS(data-value)

INTERVALHRS(data-value) INTERVALMINS(data-value) INTERVALSECS(data-value)

Conditions: INVREQ, NOTAUTH

SET DISPATCHER

SET DISPATCHER MAXHPTCBS(data-value) MAXJVMTCBS(data-value) MAXOPENTCBS(data-value) MROBATCH(data-value) PRTYAGING(data-value) RUNAWAY(data-value) SCANDELAY(data-value) TIME(data-value)

Conditions: INVREQ, NOTAUTH,

158

CICS TS for z/OS: CICS Users Handbook

SPI syntax

SET DSNAME
SET DSNAME(data-value) ACTION(cvda) REMOVE RECOVERED RESETLOCKS RETRY AVAILABILITY(cvda) AVAILABLE UNAVAILABLE QUESCESTATE(cvda) QUIESCED IMMQUIESCED UNQUIESCED

WAIT BUSY(cvda) NOWAIT UOWACTION(cvda) BACKOUT COMMIT FORCE

Conditions: DSNNOTFOUND, INVREQ, IOERR, NOTAUTH, SUPPRESSED

SET DUMPDS
SET DUMPDS INITIALDDS(data-value) OPENSTATUS(cvda) CLOSED OPEN SWITCH SWITCHSTATUS(cvda) NOSWITCH SWITCHNEXT

Conditions: INVREQ, IOERR, NOTAUTH

SET ENQMODEL
SET ENQMODEL(data-value) STATUS(cvda) DISABLED ENABLED

Conditions: INVREQ, NOTAUTH, NOTFND

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

Conditions: FILENOTFOUND, INVREQ, IOERR, NOTAUTH

Chapter 2. SPI command syntax

159

SPI syntax

options:
WAIT ADD(cvda) ADDABLE NOTADDABLE BROWSE(cvda) BROWSABLE NOTBROWSABLE BUSY(cvda) FORCE NOWAIT CFDTPOOL(data-value) DELETE(cvda) DELETABLE NOTDELETABLE

DISPOSITION(cvda) OLD SHARE

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

EMPTYSTATUS(cvda) EMPTY EMPTYREQ NOEMPTYREQ

ENABLESTATUS(cvda) DISABLED ENABLED OPENSTATUS(cvda) CLOSED OPEN

EXCLUSIVE(cvda) EXCTL NOEXCTL

KEYLENGTH(data-value)

LOADTYPE(cvda) LOAD NOLOAD

LSRPOOLID(data-value)

MAXNUMRECS(data-value)

READ(cvda) NOTREADABLE READABLE

RECORDSIZE(data-value)

READINTEG(cvda) UNCOMMITTED CONSISTENT REPEATABLE

RLSACCESS(cvda) RLS NOTAPPLIC NOTRLS

STRINGS(data-value)

TABLE(cvda) CFTABLE CICSTABLE NOTTABLE USERTABLE

TABLENAME(data-value)

UPDATE(cvda) NOTUPDATABLE UPDATABLE

UPDATEMODEL(cvda) CONTENTION LOCKING

160

CICS TS for z/OS: CICS Users Handbook

SPI syntax

SET IRC
SET IRC OPENSTATUS(cvda) CLOSED IMMCLOSE OPEN

Conditions: INVREQ, IOERR, NOSTG, NOTAUTH

SET JOURNALNAME
SET JOURNALNAME(data-value) ACTION(cvda) FLUSH RESET STATUS(cvda) DISABLED ENABLED

Conditions: INVREQ, IOERR, JIDERR, NOTAUTH

SET JVMPOOL
SET JVMPOOL STATUS(cvda) ENABLED DISABLED TERMINATE(cvda) PHASEOUT PURGE FORCEPURGE

Conditions: INVREQ, NOTAUTH

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

AVAILABLE(data-value) ACQSTATUS(cvda) ACQUIRED ACQSTATUS(cvda) CLOSED

Conditions: INVREQ, NOTAUTH, SYSIDERR

Chapter 2. SPI command syntax

161

SPI syntax

SET MONITOR
SET MONITOR CONVERSEST(cvda) CONVERSE NOCONVERSE EXCEPTCLASS(cvda) EXCEPT NOEXCEPT

FREQUENCY(data-value)

PERFCLASS(cvda) PERF NOPERF

STATUS(cvda) ON OFF

FREQUENCYHRS(data-value) FREQUENCYMIN (data-value) FREQUENCYSEC(data-value)

SYNCPOINTST(cvda) SYNCPOINT NOSYNCPOINT

Conditions: INVREQ, NOTAUTH

SET NETNAME
SET NETNAME(data-value) EXITTRACING(cvda) EXITTRACE NOEXITTRACE

Conditions: INVREQ, NOTAUTH

SET PROCESSTYPE
SET PROCESSTYPE(data-value) STATUS(cvda) DISABLED ENABLED AUDITLEVEL(cvda) ACTIVITY FULL OFF PROCESS

Conditions: INVREQ, NOTAUTH, PROCESSERR

162

CICS TS for z/OS: CICS Users Handbook

SPI syntax

SET PROGRAM
SET PROGRAM(data-value) CEDFSTATUS(cvda) CEDF NOCEDF COPY(cvda) NEWCOPY PHASEIN EXECUTIONSET(cvda) DPLSUBSET FULLAPI

HOTPOOLING(cvda) HOTPOOL NOTHOTPOOL

JVMCLASS(255-character data-area)

RUNTIME(cvda) JVM NOJVM

SHARESTATUS(cvda) PRIVATE SHARED

STATUS(cvda) DISABLED ENABLED

VERSION(cvda)

Conditions: INVREQ, IOERROR, NOTAUTH, PGMIDERR

SET STATISTICS
SET STATISTICS ENDOFDAY(data-value) INTERVAL(data-value)

ENDOFDAYHRS(data-value) ENDOFDAYMINS(data-value) ENDOFDAYSECS(data-value)

INTERVALHRS(data-value) INTERVALMINS(data-value) INTERVALSECS(data-value)

RECORDING(cvda) ON OFF

RECORDNOW

RESETNOW

Conditions: INVREQ, NOTAUTH

Chapter 2. SPI command syntax

163

SPI syntax

SET SYSDUMPCODE
SET SYSDUMPCODE(data-value) ACTION(cvda) ADD REMOVE RESET DAEOPTION(cvda) DAE NODAE DUMPSCOPE(cvda) LOCAL RELATED

MAXIMUM(data-value)

SHUTOPTION(cvda) NOSHUTDOWN SHUTDOWN

SYSDUMPING(cvda) NOSYSDUMP SYSDUMP

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

SET SYSTEM

SET SYSTEM AKP(data-value) DSALIMIT(data-value) DSRTPROGRAM(data-value) DTRPROGRAM(data-value) DUMPING(cvda) NOSYSDUMP SYSDUMP EDSALIMIT(data-value) FORCEQR(cvda) GMMTEXT(data-value) GMMLENGTH(data-value) LOGDEFER(data-area) MAXOPENTCBS(data-value) MAXTASKS(data-value) NEWMAXTASKS(data-area) MROBATCH(data-value) PROGAUTOCTLG(cvda) CTLGALL CTLGMODIFY CTLGNONE PROGAUTOEXIT(data-value) PROGAUTOINST(cvda) AUTOACTIVE AUTOINACTIVE PRTYAGING(data-value) RUNAWAY(data-value) SCANDELAY(data-value) TIME(data-value)

Conditions: INVREQ, LENGERR, NOSTG, NOTAUTH, NOTSUPERUSER

164

CICS TS for z/OS: CICS Users Handbook

SPI syntax

SET TASK
SET TASK(data-value) PRIORITY(data-value) PURGETYPE(cvda) PURGE FORCEPURGE KILL

Conditions: INVREQ, NORMAL, NOTAUTH, TASKIDERR

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

Conditions: INVREQ, NOTAUTH, TCIDERR

SET TCPIP
SET TCPIP MAXSOCKETS(data-value) NEWMAXSOCKETS(data-value) OPENSTATUS(data-value) CLOSE IMMCLOSE OPEN

Conditions: INVREQ, IOERR, NOTAUTH, NOTSUPERUSER

SET TCPIPSERVICE
SET TCPIPSERVICE(data-value) BACKLOG(data-area) OPENSTATUS(cvda) CLOSE IMMCLOSE OPEN DNSSTATUS(cvda) DEREGISTERED

URM(data-value)

Conditions: INVREQ, NOTAUTH, NOTFND

Chapter 2. SPI command syntax

165

SPI syntax

SET TDQUEUE
SET TDQUEUE(data-value) ATIFACILITY(cvda) NOTERMINAL TERMINAL ATITERMID(data-value)

ATITRANID(data-value)

ATIUSERID(data-value)

ENABLESTATUS(cvda) DISABLED ENABLED

OPENSTATUS(cvda) CLOSED OPEN

TRIGGERLEVEL(data-value)

Conditions: INVREQ, IOERR, NOTAUTH, QIDERR, USERIDERR

166

CICS TS for z/OS: CICS Users Handbook

SPI syntax

SET TERMINAL
SET TERMINAL(data-value) ACQSTATUS(cvda) TERMSTATUS(cvda) ACQUIRED COLDACQ RELEASED ALTPRINTER(data-value)

ALTPRTCOPYST(cvda) ALTPRTCOPY NOALTPRTCOPY

ATISTATUS(cvda) ATI NOATI

CREATESESS(cvda) CREATE NOCREATE

DISCREQST(cvda) DISCREQ NODISCREQ

EXITTRACING(cvda) EXITTRACE NOEXITTRACE

MAPNAME(data-value)

MAPSETNAME(data-value)

NEXTTRANSID(data-value)

OBFORMATST(cvda) OBFORMAT NOOBFORMAT

OPERID(data-value)

PAGESTATUS(cvda) AUTOPAGEABLE PAGEABLE

PRINTER(data-value)

PRTCOPYST(cvda) PRTCOPY NOPRTCOPY

PURGETYPE(cvda) FORCEPURGE PURGE FORCE KILL CANCEL

RELREQST(cvda) RELREQ NORELREQ

SERVSTATUS(cvda) INSERVICE OUTSERVICE

TCAMCONTROL(data-value)

TERMPRIORITY(data-value)

TRACING(cvda) SPECTRACE STANTRACE

TTISTATUS(cvda) NOTTI TTI

UCTRANST(cvda) UCTRAN NOUCTRAN TRANIDONLY

ZCPTRACING(cvda) NOZCPTRACE ZCPTRACE

Conditions: INVREQ, NORMAL, NOTAUTH, TERMIDERR

Chapter 2. SPI command syntax

167

SPI syntax

SET TRACEDEST
SET TRACEDEST AUXSTATUS(cvda) AUXPAUSE AUXSTART AUXSTOP GTFSTATUS(cvda) GTFSTART GTFSTOP INTSTATUS(cvda) INTSTART INTSTOP

SWITCHACTION(cvda) SWITCH

SWITCHSTATUS(cvda) NOSWITCH SWITCHALL SWITCHNEXT

TABLESIZE(data-value)

Conditions: INVREQ, IOERR, NOSPACE, NOSTG, NOTAUTH

SET TRACEFLAG
SET TRACEFLAG SINGLESTATUS(cvda) SINGLEOFF SINGLEON SYSTEMSTATUS(cvda) SYSTEMOFF SYSTEMON TCEXITSTATUS(cvda) TCEXITALL TCEXITALLOFF TCEXITNONE TCEXITSYSTEM

USERSTATUS(cvda) USEROFF USERON

Conditions: INVREQ, NOTAUTH

SET TRACETYPE

SET TRACETYPE

STANDARD SPECIAL

COMPID(data-value)

Conditions: NOTAUTH, NOTFND

168

CICS TS for z/OS: CICS Users Handbook

SPI syntax

SET TRANCLASS
SET1 SET2 SET3

SET1
SET TRANCLASS(data-value)

SET2
MAXACTIVE(data-value)

SET3
PURGETHRESH(data-value)

Conditions: INVREQ, NOTAUTH, TCIDERR

SET TRANDUMPCODE
SET TRANDUMPCODE(data-value) ACTION(cvda) ADD REMOVE RESET DUMPSCOPE(cvda) LOCAL RELATED MAXIMUM(data-value)

SHUTOPTION(cvda) NOSHUTDOWN SHUTDOWN

SYSDUMPING(cvda) NOSYSDUMP SYSDUMP

TRANDUMPING(cvda) NOTRANDUMP TRANDUMP

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

Chapter 2. SPI command syntax

169

SPI syntax

SET TRANSACTION
SET TRANSACTION(data-value) DUMPING(cvda) TRANDUMP NOTRANDUMP PRIORITY(data-value)

PURGEABILITY(cvda) NOTPURGEABLE PURGEABLE

RUNAWAY(data-value)

RUNAWAYTYPE(cvda) SYSTEM USER

SHUTDOWN(cvda) SHUTDISABLED SHUTENABLED

STATUS(cvda) DISABLED ENABLED

TCLASS(data-value) TRANCLASS(data-value)

TRACING(cvda) SPECTRACE SPRSTRACE STANTRACE

Conditions: INVREQ, NOTAUTH, TRANSIDERR

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

SYSID(data-value) POOLNAME(data-value)

ACTION(cvda) LASTUSEDINT(data-value) DELETE

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

SET UOW
SET UOW(data-value) UOWSTATE(cvda) COMMIT BACKOUT FORCE

Conditions: INVREQ, NOTAUTH, UOWNOTFOUND

170

CICS TS for z/OS: CICS Users Handbook

SPI syntax

SET UOWLINK
SET UOWLINK(data-value) ACTION(cvda) DELETE

Conditions: INVREQ, NOTAUTH, UOWLNOTFOUND

SET VTAM
SET VTAM OPENSTATUS(cvda) CLOSED FORCECLOSE IMMCLOSE OPEN PSDINTERVAL(data-value) DEREGISTERED

PSDINTHRS(data-value) PSDINTMINS(data-value) PSDINTSECS(data-value)

Conditions: INVREQ, IOERR, NOTAUTH

SET WEB
SET WEB GARBAGEINT(data-value) TIMEOUTINT(data-value)

Conditions: INVREQ, IOERR, NOTAUTH

Chapter 2. SPI command syntax

171

172

CICS TS for z/OS: CICS Users Handbook

Chapter 3. CICS-Supplied Transaction


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

CEBT INQUIRE AUXTRACE


CEBT Inquire Auxtrace

CEBT INQUIRE DUMP


CEBT Inquire Dump

CEBT INQUIRE GTFTRACE


CEBT Inquire Gtftrace

CEBT INQUIRE INTTRACE


CEBT Inquire Inttrace

CEBT INQUIRE SURVEILLANCE


CEBT Inquire Surveillance

CEBT PERFORM SHUTDOWN


CEBT Perform SHutdown Dump Immediate

Copyright IBM Corp. 1989, 2002

173

CST syntax

CEBT PERFORM SNAP


CEBT Perform SNap

CEBT PERFORM TAKEOVER


CEBT Perform Takeover Dump

CEBT SET AUXTRACE


CEBT Set Auxtrace STArt Pause STOp NOswitch NExt All SWitch

CEBT SET DUMP


CEBT Set Dump Open CLosed Switch Autoswitch Noautoswitch

CEBT SET GTFTRACE


CEBT Set Gtftrace STArt STOp

CEBT SET INTTRACE


CEbt Set Inttrace STArt STOp

174

CICS TS for z/OS: CICS Users Handbook

CST syntax

CEBT SET SURVEILLANCE


CEBT Set Surveillance OFf ON

CEBT SET TAKEOVER


CEBT Set Takeover Automatic Command Manual

CEDA

ADD
ADd Group(groupname1) LIst(name) After(groupname2) Before(groupname3)

ALTER
ALter Resource Group(name) attribute list

APPEND
APpend LIst(list1) To(list2)

CHECK
CHeck Group(name) List(list1, ..., listn)

Remotesystem(sysid)

Chapter 3. CICS-Supplied Transaction

175

CST syntax

COPY
ALl COpy Resource Route REPLACE MERGE

DEFINE
DEFine Resource Group(name) attribute list

DELETE
DELete ALl Resource Group(name) REMOVE

DISPLAY
DIsplay LIst(name) Group(name) Group(name) All Resource RENAME

EXPAND
Expand LIst(name) Group(name) Group(name) All Resource RENAME

176

CICS TS for z/OS: CICS Users Handbook

CST syntax

INSTALL
Install All Resource Group(name) LIST(name)

LOCK
Lock Group(name) List(name)

MOVE
ALl Move Resource Route REPLACE MERGE REMOVE

REMOVE
REMove Group(name) List(name)

RENAME
REName ALl Resource Route REMOVE

UNLOCK
UNlock Group(name) List(name)

Chapter 3. CICS-Supplied Transaction

177

CST syntax

USERDEFINE
USerdefine Resource Group(name) attribute list

VIEW
View Group(name) ALl Resource

178

CICS TS for z/OS: CICS Users Handbook

CST syntax

CEDA continued

Resource:
Connection(name) CORbaserver(name) DB2Conn(name) DB2Entry(name) DB2Tran(name) DJar(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)

Route (Copy and Move):


Group(from-name) AS(newname) TO(to-name) AS(newname) TO(to-name)

Route (Rename):

Group(from-name)

AS(newname)

TO(to-name)

attribute list:
for details consult the Resource Definition Guide

Chapter 3. CICS-Supplied Transaction

179

CST syntax

CEDF
,ON CEDF termid sysid sessionid ,OFF

CEDX
,ON CEDX tranid ,OFF

CEMT DISCARD

CEMT Discard Autinstmodel(value) CONnection(value) CORbaserver(value) DB2Conn DB2Entry(value) DB2TRAN(value) DJar(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)

180

CICS TS for z/OS: CICS Users Handbook

CST syntax

CEMT INQUIRE AUTOINSMODEL


CEMT Inquire AUTInstmodel All

CEMT INQUIRE AUTOINSTALL


CEMT Inquire AUTOinstall

CEMT INQUIRE AUXTRACE


CEMT Inquire AUXtrace

CEMT INQUIRE BEAN


All CEMT Inquire BEAN (value) Corbaserver(value) Djar(value)

CEMT INQUIRE CFDTPOOL


All CEMT Inquire CFdtpool (value)

Chapter 3. CICS-Supplied Transaction

181

CST syntax

CEMT INQUIRE CONNECTION


CEMT Inquire Connection (value) ALl

Netname(value)

NOTPending PEnding

INService OUtservice

ACquired RELeased OBtaining FReeing AVailable

NOTSupported Unattempted COMPlete Failed

Vtam IRc XM INDirect XCf RConnection

EXci APpc Lu61

XOk XNotdone

RECovdata NORecovdata NRs

Endaffinity

Grname(value)

Membername(value)

Nqname(value)

Remotesystem(value)

Rname(value)

Rnetname(value)

INQUIRE CORBASERVER
ALl CEMT INQUIRE CORBASERVER (value) Autopub Noauto CErtificate(value)

CLientcert(value)

Djardir(value)

Host(value)

Jndiprefix(value)

Pendinit Initing Unusable Pendresolve Resolving Unresolved Inservice Discarding

SEssbeantime(value)

SHelf(value)

Sslunauth(value)

Unauth(value)

Conditions: NOTAUTH, NOTFND

182

CICS TS for z/OS: CICS Users Handbook

CST syntax

CEMT INQUIRE DB2CONN


CEMT Inquire DB2Conn

CEMT INQUIRE DB2ENTRY


CEMT Inquire DB2Entry(data-area) Uow Task Txid None Group Sign TErm Tx Opid Userid Enabled Disabled Disabling Pool Abend Sqlcode High Equal Low

Protectnum(data-area)

Pthreads(data-area)

Threadlimit(data-area)

Threads(data-area)

Twait Notwait Tpool

Plan(data-area)

Planexitname(data-area)

Authid(data-area)

Rollback Norollback

CEMT INQUIRE DB2TRAN


CEMT Inquire Db2tran (data-area) Db2entry(data-area) Plan(data-area)

Planexitname(data-area)

Transid(data-area)

CEMT INQUIRE DELETSHIPPED


CEMT Inquire DEletshipped Idle(value) Interval(value)

Chapter 3. CICS-Supplied Transaction

183

CST syntax

| | | | |

CEMT INQUIRE DJAR


All CEMT Inquire DJar (value) Corbaserver(value) Datestamp(value)

Hfsfile(value)

Pendinit Initing Unusable Pendresolve Resolving Unresolved Inservice Discarding

Timestamp(value)

| | |

CEMT INQUIRE DOCTEMPLATE


CEMT Inquire DOctemplate Exitpgm File Member Program Tdqueue Tsqueue Name(value) Append Noappend Binary Ebcdic

Type(value)

Templatename(value)

Ddname(value)

Dsname(value)

CEMT INQUIRE DSAS


CEMT Inquire DSAs

184

CICS TS for z/OS: CICS Users Handbook

CST syntax

CEMT INQUIRE DSNAME


ALl CEMT Inquire DSName (value) Vsam Bdam Remove Recovered Resetlocks Retry Filecount(value) Valid Invalid Path Base Fwdrecovable Notrecovable Recoverable Undetermined Static Dynamic Undetermined Frlog(value) Available Unavailable Nolostlocks Remlostlocks Recoverlocks Retained Noretained Backout Commit Basedsname(value) Quiescestate Unquiesced Immquiesced Fwdrecovlsn(value)

CEMT INQUIRE DUMPDS


CEMT Inquire DUmpds Currentdds(value) Open Closed Switch Autoswitch Noautoswitch

Chapter 3. CICS-Supplied Transaction

185

CST syntax

CEMT INQUIRE ENQ


CEMT Inquire Enq Uow(value) Transid(value) Taskid(value) Active Retained

Dataset File Execenq Addrexecenq Tdq Tsq

Owner Waiter

Duration(value)

Resource(value)

Rlen(value)

Enqfails(value)

Netuowid(value)

Qualifier(value)

Qlen(value)

CEMT INQUIRE ENQMODEL


All CEMT Inquire ENQModel value Enqscope(value) Disabled Enabled Waiting Enqname(value)

CEMT INQUIRE EXCI


CEMT Inquire EXci Task(number) Urid(value)

186

CICS TS for z/OS: CICS Users Handbook

CST syntax

CEMT INQUIRE FILE


ALl CEMT Inquire FIle (value) Vsam BDam REMote OPen CLosed ENabled UNenabled DIsabled REAd NORead

UPdate NOUpdate

ADdable NOAddable

BRowse NOBrowse

DElete NODelete

EXclusive NOEXclusive

OLd Share

RLs NOTRls

EMptyreq NOEMptyreq

DSname(value)

NOTTable CIcstable USertable CFTable

LOAd NOLoad

CFDtpool(value)

Tablename(value)

LOCKING COntention

Maxnumrecs(value)

Keylength(value)

RECordsize(value)

CEMT INQUIRE GTFTRACE


CEMT Inquire Gtftrace Start Stop

CEMT INQUIRE INTTRACE


CEMT Inquire INttrace Start Stop

CEMT INQUIRE IRC


CEMT Inquire IRc Closed Open

Chapter 3. CICS-Supplied Transaction

187

CST syntax

CEMT INQUIRE JMODEL


All CEMT Inquire JModel (value) Journalname(value) Mvs Smf Dummy Streamname(value)

CEMT INQUIRE JOURNALNAME


All CEMT Inquire JOurnalname (value) Mvs Smf Dummy Enabaled Disabled Failed Flush Reset

Streamname(value)

CEMT INQUIRE JVMPOOL


CEMT Inquire JVmpool Enabled Disabled Total(number) Phasingout(number)

CEMT INQUIRE LINE


CEMT Inquire Line (value) Number(value) Negpoll(value) Inservice Outservice

188

CICS TS for z/OS: CICS Users Handbook

CST syntax

CEMT INQUIRE MODENAME


All CEMT Inquire MODename (value) Connection(value) Maximum(value)

Available(value)

Active(value)

Acquired Closed

CEMT INQUIRE MONITOR


CEMT Inquire MONitor On Off Perf NOPerf Except NOExcept Converse NOConverse Syncpoint NOSyncpoint

Frequency(value)

Filelimit(value)

Tsqueuelimit(value)

Applname NOApplname

Rmi NORmi

Gmt Local

Subsystemid(value)

CEMT INQUIRE NETNAME


ALl CEMT Inquire Netname (value) Transaction(value) Priority(value)

Pageable Autopageable

Inservice Outservice

Ati Noati

Tti Notti

Rterminal Rsession Session Local

Purge Forcepurge

Terminal(value)

Acquired Released Coldacq

Create Nocreate

Task(value)

Nqname(value)

Remotesystem(value)

Rname(value)

Rnetname(value)

Cid(value)

Userid

Chapter 3. CICS-Supplied Transaction

189

CST syntax

CEMT INQUIRE PARTNER


All CEMT Inquire PArtner (value) Network(value) Netname(value) Profile(value)

Ltpname(value)

Tpname(value)

CEMT INQUIRE PROCESSTYPE


ALl CEMT Inquire PROCesstype (value) FIle (value) Activity Full Off Disabled Enabled

CEMT INQUIRE PROFILE


All CEMT Inquire PROFile (value)

190

CICS TS for z/OS: CICS Users Handbook

CST syntax

CEMT INQUIRE PROGRAM


ALl CEMT Inquire PROGram (value) CLass(value) LENgth(value) PLi Cobol C Le370 Assembler Java Notapplic Notdefined Program Mapset Partitionset

Enabled Disabled

Shared Private

Notrequired Required Newcopy Phasein

Cedf Nocedf

Dynamic Notdynamic

Rescount(value)

Usecount(value)

PLi Cobol C Le370 Assembler Java Notapplic Notdefined

Program Mapset Partitionset

Enabled Disabled

Shared Private

Notrequired Required Newcopy Phasein

Cedf Nocedf

Any Below

Cexeckey Uexeckey

Dplsubset Fullapi

Threadsafe

|
Remotesystem(value) Jvm Lenv Native Unknown Hotpool Nothotpool JvmClass(value)

Jvmprofile(value)

Chapter 3. CICS-Supplied Transaction

191

CST syntax

CEMT INQUIRE REQUESTMODEL


ALl CEMT Inquire REquestmodel (value) Corbaserver(data-area) Transid(name)

Ejb Corba Generic

Home Remote Both Notapplic

Module(data-area)

Interface(data-area)

Operation(data-area)

Beanname(data-area)

CEMT INQUIRE RRMS


CEMT Inquire RRms Closed Open

CEMT INQUIRE STATISTICS


CEMT Inquire STAtistics

CEMT INQUIRE STREAMNAME


ALl CEMT Inquire STReamname (value) Usecount(value) Ok Failed Syslog Nosyslog

192

CICS TS for z/OS: CICS Users Handbook

CST syntax

CEMT INQUIRE SYDUMPCODE


ALl CEMT Inquire SYDumpcode (value) Reset Remove Add Sysdump Nosysdump Related Local Shutdown Noshutdown

Dae Nodae

Maximum(value)

Current(value)

CEMT INQUIRE SYSTEM


CEMT Inquire SYStem

Chapter 3. CICS-Supplied Transaction

193

CST syntax

| | |

CEMT INQUIRE TASK


ALl CEMT Inquire TAsk (value) TClass(value) Tranid(value) Facility(value) Purge Forcepurge

| |

Running Dispatchable Suspended

Task Term Dest

Priority(value)

D Ds Qd S Sd To Tp U

Userid(value)

Uow(value)

| |

Htype(value)

Hvalue(value)

Htime(value)

Backout Commit

Bridge(value)

| |

Identifier(value)

Indoubtmins(value)

Nowait Wait

Db2plan(value)

| | | |

Activityid(value)

Activity(value)

Process(value)

Processtype(value)

Ckopen Internal Qr Ukopen

Brfacility(value)

| | |

CEMT INQUIRE TCLASS


ALl CEMT Inquire TClass (value) Maxactive(value) Active(value)

Purgethresh(value)

Queued(value)

194

CICS TS for z/OS: CICS Users Handbook

CST syntax

CEMT INQUIRE TCPIP


INQUIRE TCPIP Open Closed Closing Immclosing Actsockets(value) Maxsockets(value)

| | | | |

CEMT INQUIRE TCPIPSERVICE


INQUIRE TCPIPService(value) Backlog(value) Connection(value) Port(value)

Ssl Nossl Clientauth

Noauthentic Basic Certificate Register Automatic

Required Supported Notsupported

Open Closed Closing Immclosing

Transid(value)

| | | |

Urm(value)

Ipaddress(value)

Http Iiop

Wait Timeout

Closetimeout(value)

Dnsgroup(name)

Notapplic Unavailable Unregistered Registered Regerror Deregistered Deregerror

Critical Noncritical

Certificate(value)

| | | | |

Tsqprefix(value)

Chapter 3. CICS-Supplied Transaction

195

CST syntax

CEMT INQUIRE TDQUEUE


All CEMT Inquire TDqueue (value) Triggerlevel(value) Indirect Extra Intra Remote Nameind(value)

Enabled Disabled

Open Closed

Termid(value)

Tranid(value)

Userid(value)

Shr Old Mod

Input Output Rdback

Queue

Reject

Nowait Wait

Indoubt(value)

Databuffers(value)

Ddname(value)

Dsname(value)

Member

CEMT INQUIRE TERMINAL


ALl CEMT Inquire TErminal (value) CLass(value) Transaction(value) Console(value)

Priority(value)

Pageable Autopageable

Inservice Outservice

Ati Noati

Tti Notti

Rterminal Rsession Session Local

Acquired Released Coldacq

Create Nocreate

Purge Forcepurge

Netname(value)

Task(value)

Remotesystem(value)

Nqname(value)

Rname(value)

Rnetname(value)

Userid(value)

Cid(value)

196

CICS TS for z/OS: CICS Users Handbook

CST syntax

CEMT INQUIRE TRANSACTION


ALl CEMT Inquire TRAnsaction (value) CLass(value) Otstimeout(value) Priority(value)

Program(value)

Tclass(value)

Enabled Disabled

Purgeable Notpurgeable

Cdatakey Udatakey

Any Below

Isolate Noisolate

Backout Commit

Nowait Wait

Notroutable Routable

Prfile(value)

Trprof(value)

Brexit(value)

Facilitylike(value)

Indoubtmins(value)

CEMT INQUIRE TRDUMPCODE


ALl CEMT Inquire TRDumpcode (value) Reset Rmove Add Trandump Notrandump Sysdump Nosysdump

Shutdown Noshutdown

Dumpscope

Related Local

Maximum(value)

Current(value)

CEMT INQUIRE TSMODEL


ALl CEMT Inquire TSModel (value) Auxiliary Main Recoverable Notrecovable Security Nosecurity

Poolname(data-area) Prefix(data-area) Remoteprefix(data-area) Remotesystem(data-area)

Chapter 3. CICS-Supplied Transaction

197

CST syntax

CEMT INQUIRE TSPOOL


ALl CEMT Inquire TSPool (value) Connected Unconnected

CEMT INQUIRE TSQUEUE/TSQNAME


ALl CEMT Inquire TSQueue (value) Sysid(value) Poolname(value) Numitems(value)

Lastusedint(value)

Length(value)

Auxiliary Main

Recoverable Notrecovable

Maxitemlen(value)

Minitemlen(value)

Transid(value)

CEMT INQUIRE UOW


ALl CEMT Inquire UOW (value) Backout Commit Indoubt Inflight Hbackout Hcommit Force Active Waiting Shunted Connection Dataset Otscoord Rlsserver Rrms Waitcommit Waitforget Waitrmi Transid(value)

Taskid(value)

Age(value)

Termid(value)

Netname(value)

Userid(value)

Link(value)

Sysid(value)

Netuowid(value)

Otstid(value)

198

CICS TS for z/OS: CICS Users Handbook

CST syntax

CEMT INQUIRE UOWDSNFAIL


CEMT Inquire UOWDsnfail Uow(value) Dsname(value) Rls Notrls Cache Connection Dataset Rlsserver Undefined

Backupnonbwo Commitfail Datasetfull Deadlock Delexiterror Failedbkout Indexrecfull Indoubt Ioerror lckstrucfull notapplic Openerror Rlsgone Rrcommitfail Rrindoubt

Sysid(value)

Netname(value)

CEMT INQUIRE UOWENQ


CEMT Inquire UOWEnq Uow(value) Transid(value) Taskid(value) Owner Waiter

Active Retained

Dataset File Execenq Addrexecenq Tdq Tsq

Duration(value)

Netuowid(value)

Enqfails(value)

Resource(value)

Rlen(value)

Qualifier(value)

Qlen(value)

Chapter 3. CICS-Supplied Transaction

199

CST syntax

CEMT INQUIRE UOWLINK


ALl CEMT Inquire UOWLink (value) Uow(value) Cftable Connection Iiop Rmi Coordinator Subordinate Unknown Irc Appc Lu61 Ots Rrms

Cold Starting Ok Unavailable Unconnected

Host(value)

Link(value)

Sysid(value)

Rmiqfy(value)

Netuowid(value)

CEMT INQUIRE VTAM


CEMT Inquire Vtam Open Closed Immclose Forceclose Registered Deregistered Unregistered Unavailable Psdinterval(value)

Grname(value)

CEMT INQUIRE WEB


INQUIRE WEB Garbageint(value) Timeoutint(value)

CEMT PERFORM CORBASERVER


CEMT Perform Corbaserver(value) Publish Retract Scan

200

CICS TS for z/OS: CICS Users Handbook

CST syntax

CEMT PERFORM DELETSHIPPED


CEMT Perform DEletshipped

CEMT PERFORM DJAR


CEMT Perform DJar(value) Publish Retract

CEMT PERFORM DUMP


CEMT Perform DUmp SNap

Title(value)

CEMT PERFORM ENDAFFINITY


CEMT Perform Endaffinity NETName(value) NETId(value)

CEMT PERFORM RESET


CEMT Perform Reset

CEMT PERFORM SECURITY


CEMT Perform SEcurity Rebuild

Chapter 3. CICS-Supplied Transaction

201

CST syntax

CEMT PERFORM SHUTDOWN


CEMT Perform SHUTdown Xlt(value) Plt(value) Sdtran(value) NOSdtran

Immediate NORestart

Takeover

Dump

| |

CEMT PERFORM STATISTICS

CEMT Perform STatistics RECORd

ALl RESetnow AUtoinstall Connection CORbaserver DB2 DIspatcher Enqueue FEpi FIle Journalname JVMpool Lsrpool Monitor PROGAuto PROGRam RECOVery REQuestmodel STAts STOrage STReamname SYsdump TAblemgr TCLass TCPIP TCPipservice TDqueue TErminal TRAnsaction TRDump TSqueue Vtam

| | |

202

CICS TS for z/OS: CICS Users Handbook

CST syntax

| |

CEMT SET AUTOINSTALL


CEMT Set AUToinstall PROGAUTO FULLAUTO NOAUTO Maxreqs(value) SETA2 AUTOTERMID URMTERMID

| | | | | | SETA2
Program(value)

CEMT SET AUXTRACE


CEMT Set AUXtrace STArt Pause STOp NOswitch NExt All SWitch

CEMT SET CONNECTION


CEMT Set Connection (value) ALl

NOTpending

INService OUtservice

ACquired RELeased

PUrge FORCEPurge Kill CAncel FCancel

COmmit Backout FORCEUow RESync

ENdaffinity

NORecovdata

| |

CEMT SET CORBSERVER


CEMT Set CORbaserver (value) ALl

AUtopub Noauto

SEssbeantime(value)

| | |

Chapter 3. CICS-Supplied Transaction

203

CST syntax

| |

CEMT SET DB2CONN

CEMT Set DB2Conn UOW TASK TXID NONE AUTHID(data-area) GROUP SIGN TERM TX OPID USERID COMAUTHID(data-area) CGROUP CSIGN CTERM CTX COPID CUSERID COMTHREADLIM(data-area) ABEND SQLCODE CONNECTED NOTCONNECTED FORCENOTCON DB2GROUPID(data-area) DB2ID(data-area) MSGQUEUE1(data-area) MSGQUEUE2(data-area) MSGQUEUE3(data-area) RELEASE NORELEASE PLAN(data-area) PLANEXITNAME(data-area) HIGH EQUAL LOW PURGECYCLEM(data-area) PURGECYCLES(data-area) RESYNC NORESYNC SIGNID(data-area) REBUILD NOCONNECT CONNECT RECONNECT STATSQUEUE(data-area) TCBLIMIT(data-area) THREADLIMIT(data-area) TWAIT NOTWAIT

| | |

204

CICS TS for z/OS: CICS Users Handbook

CST syntax

CEMT SET DB2ENTRY

CEMT Set DB2Entry (data-area) UOW TASK TXID NONE AUTHID(data-area) GROUP SIGN TERM TX OPID USERID ABEND SQLCODE POOL ENABLED DISABLED FORCEDISABLED PLAN(data-area) PLANEXITNAME(data-area) HIGH EQUAL LOW PROTECTNUM(data-area) THREADLIMIT(data-area) TWAIT NOTWAIT TPOOL

CEMT SET DB2TRAN

CEMT Set DB2Tran DB2Entry(data-area) Transid(data-area)

CEMT SET DELETSHIPPED


CEMT Set DEletshipped INterval(value) IDle(value)

Chapter 3. CICS-Supplied Transaction

205

CST syntax

CEMT SET DSAS


CEMT Set DSAs Dsalimit(value) EDsalimit(value)

CEMT SET DSNAME


CEMT Set DSName (value) ALl

REMOve RECOVEREd RESetlocks RETRy

AVailable UNAvailable

Quiesced UNQuiesced IMmquiesced

BACkout Commit FOrce

CEMT SET DUMPDS


CEMT Set DUmpds Open CLosed Switch Autoswitch Noautoswitch

CEMT SET ENQMODEL


CEMT Set ENQModel(value) Enabled DIsabled

206

CICS TS for z/OS: CICS Users Handbook

CST syntax

CEMT SET FILE


CEMT Set FIle (value) ALl

OPen CLosed Forceclose

ENabled DIsabled

REAd NORead

UPdate NOUpdate

ADdable NOAddable

BRowse NOBrowse

DElete NODelete

EXclusive NOEXclusive

EMptyreq NOEMptyreq

Old Share

RLs NOTRls

DSname(value)

NOTTable CIcstable USertable CFTable

LOAd NOLoad

CFDtpool(value)

Tablename(value)

COntention LOCking

Maxnumrecs(value)

Keylength(value)

RECordsize(value)

CEMT SET GTFTRACE


CEMT Set Gtftrace STArt STOp

CEMT SET INTTRACE


CEMT Set INttrace STArt STOp

CEMT SET IRC


CEMT SET IRc Open Closed Immclose

Chapter 3. CICS-Supplied Transaction

207

CST syntax

CEMT SET JOURNALNAME


CEMT Set Journalname(value) (value) All Enabled DIsabled FLush Reset

CEMT SET JVMPOOL


CEMT Set JVmpool Enabled Disabled Phaseout Purge Forcepurge

CEMT SET LINE


CEMT Set Line(value) NUmber(value) NEgpoll(value) Inservice Outservice Purge Forcepurge

CEMT SET MODENAME


CEMT Set MODename (value) ALl

COnnection(value)

AVailable(value)

ACQuired CLosed

CEMT SET MONITOR


CEMT Set MONitor ON OFf Perf NOPerf EXcept NOEXcept Converse NOConverse SYncpoint NOSyncpoint

Frequency(value)

208

CICS TS for z/OS: CICS Users Handbook

CST syntax

CEMT SET NETNAME


CEMT Set Netname (value) ALl

PRiority(value)

PAgeable AUtopageable

Inservice Outservice

ATi NOAti

TTi NOTti

PUrge Forcepurge Kill

ACquired COldacq RELeased

CReate NOCreate

CEMT SET PROCESSTYPE


ALl CEMT Set PROCesstype (value) ACtivity FUll Off Process Enabled Disabled

CEMT SET PROGRAM


PRIvate CEMT Set Program (value) ALl CLass(value) Enabled DIsabled Shared NEwcopy PHasein CEDf NOCedf

|
DPlsubset Fullapi JVMClass(value) Hotpool NOTHotpool JVM NOJVM

CEMT SET STATISTICS


CEMT Set STatistics ON OFf RESetnow RECordnow Interval(hhmmss)

Endofday(hhmmss)

Chapter 3. CICS-Supplied Transaction

209

CST syntax

CEMT SET SYDUMPCODE


CEMT Set SYDumpcode (value) ALl SYsdump NOSYsdump SHutdown NOSHutdown RELated Local

Maximum(value)

RESet REMove ADd

Dae NODae

CEMT SET SYSTEM

CEMT Set SYStem AGing(value) AKp(value) DSAlimit(value) DSRtprogram(value) DTrprogram(value) EDsalimit(value) Forceqr Force NOForce Logdefer(value) MAxtasks(value) MRobatch(value) CTLGAll CTLGModify CTLGNone Progautoexit(value) AUTOActive AUTOInactive RUnaway(value) SCandelay(value) Time(value) SYsdump NOSysdump

CEMT SET TASK


CEMT Set TAsk (value) All

PRiority(value)

PUrge FOrcepurge Kill

210

CICS TS for z/OS: CICS Users Handbook

CST syntax

CEMT SET TCLASS


CEMT Set TClass (value) ALl

Maxactive(value)

Purgethresh(value)

CEMT SET TCPIP


CEMT Set TCPIP (value) ALl OPEN CLOSE IMMCLOSE MAXSockets(data-value)

CEMT SET TCPIPSERVICE


CEMT Set TCPIPSERVICE (value) ALl

Backlog(value)

DEREGIstered

OPEN CLOSE IMMCLOSE

URM(value)

CEMT SET TDQUEUE


CEMT Set TDqueue (value) All

TRIggerlevel(value)

ENabled DIsabled

OPen Closed

CEMT SET TERMINAL


CEMT Set TErminal (value) CLass(value) ALl

PRiority(value)

PAgeable AUtopageable

Inservice Outservice

ATi NOAti

TTi NOTti

PUrge Forcepurge Kill CAncel

ACquired COldacq RELeased

CReate NOCreate

Chapter 3. CICS-Supplied Transaction

211

CST syntax

CEMT SET TRANSACTION


CEMT Set TRAnsaction (value) CLass(value) ALl

PRIority(value)

TClass(value)

Enabled Disabled

PUrgeable NOTpurgeable

CEMT SET TRDUMPCODE


CEMT Set TRDumpcode (value) ALl

Trandump NOTrandump

SYsdump NOSYsdump

SHutdown NOSHutdown

RELated Local

Maximum(value)

RESet REMove ADd

CEMT SET TSQUEUE


ALl CEMT Set TSqueue (value) SYSID(value) POOLNAME(value) LAstusedint(value) Action(value) DELETE

CEMT SET UOW


CEMT Set UOW(value) (value) ALl COMmit Backout Force

CEMT SET UOWLINK


CEMT Set UOWlink(value) (value) ALl Delete

212

CICS TS for z/OS: CICS Users Handbook

CST syntax

CEMT SET VTAM


CEMT Set Vtam Open Closed Immclose Forceclose

Psdinterval(hhmmss)

Deregistered

CEMT SET WEB


CEMT Set Web Garbageint(value) Timeoutint(value)

CEOT
CEOT PAgeable AUtopageable ATi NOAti UCtran NOUctran TRanidonly

CESF
CESF GOODNIGHT LOGOFF

CESN
CESN USERID=uuuuuuuu CESN USERID=uuuuuuuu GROUPID=gggggggg ,LANGUAGE=lll

(1) ,PS=pppppppp ,NEWPS=password

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

Chapter 3. CICS-Supplied Transaction

213

CST syntax

CMSG
CMSG MSG= ,ROUTE= Termid /opid ALL message

.termlist

,termid /opid

,OPCLASS=n

,TIME=value

,DATE=value ,FULLDATE=value

,ERRTERM=

Termid ORIG

,ID=(title)

,HEADING=

YES NO

,PROTECT=

YES NO Prefix

,SEND ,CANCEL

ROUTE

ROUTE=

Termid *ldc /opid ALL *ldc

.termlist *ldc ,termid *ldc /opid

CRTE
CRTE SYSID=sysid ,TRPROF=trprof

214

CICS TS for z/OS: CICS Users Handbook

CST syntax

CSFE SPOOLFE
CSFE spoolfe= ON OFF

CSFE ZCQTRACE
CSFE zcqtrace =termid ,AUTOINSTALL ,OFF

CSFE DEBUG TRANID


CSFE debug ,TRANID=xxxx ,TASKREQ=yyy ,STGFRZ= ON

OFF

CSFE DEBUG CHKSTSK


CSFE debug ,CHKSTSK= ,CHKSTRM= CURRENT NONE CURRENT NONE

CSPG GETPAGE
CSPG Getpage A B *ldc *ALL ,hhhhhh

CSPG MESSCHNYYYY
CSPG Messchnyyyy Parameters

Chapter 3. CICS-Supplied Transaction

215

CST syntax

CSPG MSGTERM
CSPG Msgterm A B C H R

,hhhhhh

CWTO
CWTO Message

216

CICS TS for z/OS: CICS Users Handbook

Chapter 4. Resource definition online


The syntax diagrams that follow are taken from the CICS Resource Definition Guide.

ADD syntax
ADd Group(groupname1) LIst(listname) Before(groupname2) After(groupname3)

ALTER syntax
ALter Connection(name) CORbaserver(name) DB2Conn(name) DB2Entry(name) DB2Tran(name) DJar(name) DOctemplate(name) Enqmodel(name) File(name) Journalmodel(name) Lsrpool(name) Mapset(name) PARTItionset(name) PARTNer(name) PROCesstype(name) PROFile(name) PROGram(name) Requestmodel(name) Sessions(name) TCpipservice(name) TErminal(name) TDqueue(name) TRANClass(name) TRANSaction(name) TSmodel(name) TYpeterm(name) Group(groupname) attribute list(new value)

APPEND syntax
APpend LIst(listname1) To(listname2)

Copyright IBM Corp. 1989, 2002

217

RDO

CHECK syntax
CHeck Group(groupname) List(listname1, listname2, listname3, listname4)

Remotesystem(sysid)

COPY syntax
All COpy Connection(name) CorbaServer(name) DB2Conn(name) DB2Entry(name) DB2Tran(name) CORbaserver(name) DJar(name) Enqmodel(name) File(name) Journalmodel(name) Lsrpool(name) Mapset(name) PARTItionset(name) PARTNer(name) PROCesstype(name) PROFile(name) PROGram(name) Requestmodel(name) Sessions(name) TCpipservice(name) TDqueue(name) TErminal(name) TRANClass(name) TRANSaction(name) TSmodel(name) TYpeterm(name) Group(groupname) AS(newname) TO(newgroupname) AS(new-name) TO(newgroupname)

Replace MErge

218

CICS TS for z/OS: CICS Users Handbook

RDO

DEFINE syntax
DEFine Connection(name) CORbaserver(name) DB2Conn(name) DB2Entry(name) DB2Tran(name) DJar(name) DOctemplate(name) Enqmodel(name) File(name) Journalmodel(name) LSRpool(name) Mapset(name) PARTItionset(name) PARTNer(name) PROCesstype(name) PROFile(name) PROGram(name) Requestmodel(name) Sessions(name) TCpipservice(name) TDqueue(name) TErminal(name) TRANClass(name) TRANSaction(name) TSmodel(name) TYpeterm(name) Group(groupname) attribute list(newvalue)

Chapter 4. Resource definition online

219

RDO

DELETE syntax
DELete All Connection(name) CORbaserver(name) DB2Conn(name) DB2Entry(name) DB2Tran(name) DJar(name) DOctemplate(name) Enqmodel(name) File(name) Journalmodel(name) Lsrpool(name) Mapset(name) PARTItionset(name) PARTNer(name) PROCesstype(name) PROFile(name) PROGram(name) Requestmodel(name) Sessions(name) TCpipservice(name) TDqueue(name) TErminal(name) TRANClass(name) TRANSaction(name) TSmodel(name) TYpeterm(name) Group(groupname) REMove

220

CICS TS for z/OS: CICS Users Handbook

RDO

DISPLAY syntax
DISplay List(listname) Group(groupname) Group(groupname) ALl(name) Connection(name) CORbaserver(name) DB2Conn(name) DB2Entry(name) DB2Tran(name) DJar(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) REname

Chapter 4. Resource definition online

221

RDO

EXPAND syntax
EXPand List(listname) Group(groupname) Group(groupname) ALl(name) Connection(name) CORbaserver(name) DB2Conn(name) DB2Entry(name) DB2Tran(name) DJar(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) REname

222

CICS TS for z/OS: CICS Users Handbook

RDO

INSTALL syntax
Install ALl(name) Connection(name) CORbaserver(name) DB2Conn(name) DB2Entry(name) DB2Tran(name) DJar(name) DOctemplate(name) Enqmodel(name) File(name) Journalmodel(name) Lsrpool(name) Mapset(name) PARTItionset(name) PARTNer(name) PROCesstype(name) PROFile(name) PROGram(name) Requestmodel(name) TCpipservice(name) TDqueue(name) TErminal(name) TRANClass(name) TRANSaction(name) TSmodel(name) TYpeterm(name) Group(groupname) List(listname)

LOCK syntax
Lock Group(groupname) List(listname)

Chapter 4. Resource definition online

223

RDO

MOVE syntax
All Move Connection(name) CORbaserver(name) DB2Conn(name) DB2Entry(name) DB2Tran(name) DJar(name) DOctemplate(name) Enqmodel(name) File(name) Journalmodel(name) Lsrpool(name) Mapset(name) PARTItionset(name) PROCesstype(name) PROFile(name) PROGram(name) Requestmodel(name) Sessions(name) TCpipservice(name) TDqueue(name) TErminal(name) TRANClass(name) TRANSaction(name) TSmodel(name) TYpeterm(name) Group(groupname) REMove AS(newname) TO(newgroupname) AS(newname) TO(newgroupname)

REPlace MErge

REMOVE syntax
REMove Group(groupname) List(listname)

224

CICS TS for z/OS: CICS Users Handbook

RDO

RENAME syntax
REName ALl(name) Connection(name) CORbaserver(name) DB2Conn(name) DB2Entry(name) DB2Tran(name) DJar(name) DOctemplate(name) Enqmodel(name) File(name) Journalmodel(name) Lsrpool(name) Mapset(name) PARTItionset(name) PARTNer(name) PROCesstype(name) PROFile(name) PROGram(name) REQuestmodel(name) Sessions(name) TCpipservice(name) TDqueue(name) TErminal(name) TRANClass(name) TRANSaction(name) TSmodel(name) TYpeterm(name) Group(groupname) AS(newname) TO(newgroupname)

REMove

UNLOCK syntax
UNLock Group(groupname) List(listname)

Chapter 4. Resource definition online

225

RDO

USERDEFINE syntax
USerdefine Connection(name) CORbaserver(name) DB2Conn(name) DB2Entry(name) DB2Tran(name) DJar(name) DOctemplate(name) Enqmodel(name) File(name) Journalmodel(name) Lsrpool(name) Mapset(name) PARTItionset(name) PARTNer(name) PROCesstype(name) PROFile(name) PROGram(name) Requestmodel(name) Sessions(name) TCpipservice(name) TDqueue(name) TErminal(name) TRANClass(name) TRANSaction(name) TSmodel(name) TYpeterm(name) Group(groupname) attribute list(newvalue)

226

CICS TS for z/OS: CICS Users Handbook

VIEW syntax
View Group(groupname) ALl(name) Connection(name) CORbaserver(name) DB2Conn(name) DB2Entry(name) DB2Tran(name) DJar(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)

Chapter 4. Resource definition online

227

228

CICS TS for z/OS: CICS Users Handbook

Chapter 5. DFHCSDUP commands


The syntax diagrams that follow are taken from the CICS Operations and Utilities Guide.

ADD syntax
ADd Group(groupname) LIst(listname)

ALTER syntax
ALter Connection(name) CORbaserver(name) DB2Conn(name) DB2Entry(name) DB2Tran(name) DJar(name) DOctemplate(name) Enqmodel(name) File(name) Journalmodel(name) Lsrpool(name) Mapset(name) PARTItionset(name) PARTNer(name) PROCesstype(name) PROFile(name) PROGram(name) Requestmodel(name) Sessions(name) TCpipservice(name) TDqueue(name) TErminal(name) TRANClass(name) TRANSaction(name) TSmodel(name) TYpeterm(name) Group(groupname) attribute list(new value)

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

Copyright IBM Corp. 1989, 2002

229

CSD

COPY syntax
Copy Group(groupname1) To(groupname2) Replace MErge FRomcsd(ddname)

DEFINE syntax
DEFine Connection(name) CORbaserver(name) DB2Conn(name) DB2Entry(name) DB2Tran(name) DJar(name) DOctemplate(name) Enqmodel(name) File(name) Journalmodel(name) LSRpool(name) Mapset(name) PARTItionset(name) PARTNer(name) PROCesstype(name) PROFile(name) PROGram(name) Requestmodel(name) Sessions(name) TCpipservice(name) TDqueue(name) TErminal(name) TRANClass(name) TRANSaction(name) TSmodel(name) TYpeterm(name) Group(groupname) attribute list(newvalue)

230

CICS TS for z/OS: CICS Users Handbook

CSD

DELETE syntax
DELete List(listname) Group(groupname)

All Connection(name) CORbaserver(name) DB2Conn(name) DB2Entry(name) DB2Tran(name) DJar(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)

REMove

EXTRACT syntax
EXtract Group(groupname) LIst(listname) USerprogram(DFHxCRFy) USerprogram(DFHxFORy) USerprogram(DFH0CBDC) USerprogram(user-written program)

Objects

INITIALIZE syntax
INITialize

Chapter 5. DFHCSDUP commands

231

CSD

LIST syntax
All LIst Group(groupname) LIst(listname) Objects

MIGRATE syntax
MIgrate TAble(tablename) TYpesgroup(typesgroupname) TOGROUP(groupname)

REMOVE syntax
Remove Group(groupname) LIst(listname)

SCAN syntax
SCAN Connection(name) CORbaserver(name) DB2Conn(name) DB2Entry(name) DB2Tran(name) DJar(name) DOctemplate(name) Enqmodel(name) File(name) Journalmodel(name) Lsrpool(name) Mapset(name) PARTItionset(name) PARTNer(name) PROCesstype(name) PROFile(name) PROGram(name) Requestmodel(name) Sessions(name) TCpipservice(name) TDqueue(name) TErminal(name) TRANClass(name) TRANSaction(name) TSmodel(name) TYpeterm(name)

ALIAS(aliasname)

232

CICS TS for z/OS: CICS Users Handbook

CSD

SERVICE syntax
Service FRomcsd(ddname) LEvel(nnn)

UPGRADE syntax
UPgrade USing(filename) Replace

VERIFY syntax
VERIFY

Chapter 5. DFHCSDUP commands

233

234

CICS TS for z/OS: CICS Users Handbook

Chapter 6. Front End Programming Interface command reference


This chapter contains General Use Programming Interface information.

FEPI application programming


FEPI ALLOCATE PASSCONVID
FEPI ALLOCATE PASSCONVID(data-value)

Conditions: INVREQ

FEPI ALLOCATE POOL


FEPI ALLOCATE POOL(data-value) CONVID(data-area) TARGET(data-value)

TIMEOUT(data-value)

SEQNUMIN(data-area)

SEQNUMOUT(data-area)

SESSNSTATUS(cvda)

Conditions: INVREQ

FEPI AP NOOP
FEPI AP NOOP

Conditions: INVREQ

Previously allocated conversation

Copyright IBM Corp. 1989, 2002

235

FEPI programming

FEPI CONVERSE DATASTREAM


FEPI CONVERSE DATASTREAM CONVID(data-value) FROM(data-value) FROMFLENGTH(data-value)

CHAIN RU UNTILCDEB ENDSTATUS(cvda) FMH FMHSTATUS(cvda)

INTO(data-area)

INTO options

REMFLENGTH(data-area)

RESPSTATUS(cvda)

SEQNUMIN(data-area)

SEQNUMOUT(data-area)

TIMEOUT(data-value)

INTO options:

MAXFLENGTH(data-value)

TOFLENGTH(data-area)

Conditions: INVREQ

Temporary conversation

236

CICS TS for z/OS: CICS Users Handbook

FEPI programming

FEPI CONVERSE DATASTREAM


FEPI CONVERSE DATASTREAM POOL(data-value) TARGET(data-value) FROM(data-value)

UNTILCDEB FROMFLENGTH(data-value) ENDSTATUS(cvda) FMH FMHSTATUS(cvda)

INTO(data-area)

INTO options

REMFLENGTH(data-area)

RESPSTATUS(cvda)

SEQNUMIN(data-area)

SEQNUMOUT(data-area)

TIMEOUT(data-value)

INTO options:

MAXFLENGTH(data-value)

TOFLENGTH(data-area)

Conditions: INVREQ

Previously allocated conversation

Chapter 6. FEPI command reference

237

FEPI programming

FEPI CONVERSE FORMATTED


FEPI CONVERSE FORMATTED CONVID(data-value) FROM(data-value) FROMFLENGTH(data-value) AID(data-value) FROMCURSOR(data-value) KEYSTROKES ESCAPE(data-value) INTO(data-area) INTO options

ALARMSTATUS(cvda)

COLUMNS(data-area)

ENDSTATUS(cvda)

FIELDS(data-area)

LINES(data-area)

RESPSTATUS(cvda)

TIMEOUT(data-value)

TOCURSOR(data-area)

INTO options:

MAXFLENGTH(data-value)

TOFLENGTH(data-area)

Conditions: INVREQ

Temporary conversation

238

CICS TS for z/OS: CICS Users Handbook

FEPI programming

FEPI CONVERSE FORMATTED


FEPI CONVERSE FORMATTED POOL(data-value) TARGET(data-value) KEYSTROKES FROMFLENGTH(data-value) ESCAPE(data-value) FROM(data-value)

INTO(data-area)

INTO options

ALARMSTATUS(cvda)

COLUMNS(data-area)

ENDSTATUS(cvda)

FIELDS(data-area)

LINES(data-area)

RESPSTATUS(cvda)

TIMEOUT(data-value)

TOCURSOR(data-area)

INTO options:

MAXFLENGTH(data-value)

TOFLENGTH(data-area)

Conditions: INVREQ

FEPI EXTRACT CONV


FEPI EXTRACT CONV CONVID(data-value) DEVICE(cvda) FORMAT(cvda)

POOL(data-area)

TARGET(data-area)

NODE(data-area)

SENSEDATA(data-area)

Conditions: INVREQ

Chapter 6. FEPI command reference

239

FEPI programming

FEPI EXTRACT FIELD


FEPI EXTRACT FIELD CONVID(data-value) FIELDLOC(data-value) FIELDNUM(data-value)

INTO(data-area)

INTO options

BACKGROUND(data-area)

COLOR(data-area)

FIELDATTR(data-area)

HILIGHT(data-area)

INPUTCONTROL(data-area)

MDT(cvda)

OUTLINE(data-area)

POSITION(data-area)

PROTECT(cvda)

PS(data-area)

SIZE(data-area)

TRANSPARENCY(data-area)

VALIDATION(data-area)

INTO options:

MAXFLENGTH(data-value)

FLENGTH(data-area)

Conditions: INVREQ

FEPI EXTRACT STSN


FEPI EXTRACT STSN CONVID(data-value) SEQNUMIN(data-area) SEQNUMOUT(data-area)

STSNSTATUS(cvda)

Conditions: INVREQ

FEPI FREE
HOLD FEPI FREE CONVID(data-value) RELEASE FORCE PASS

Conditions: INVREQ

240

CICS TS for z/OS: CICS Users Handbook

FEPI programming

FEPI ISSUE
FEPI ISSUE CONVID(data-value) CONTROL(cvda) SENSEDATA(data-value) VALUE(cvda)

Conditions: INVREQ

FEPI RECEIVE DATASTREAM


CHAIN FEPI RECEIVE DATASTREAM CONVID(data-value) RU UNTILCDEB ENDSTATUS(cvda)

FMHSTATUS(cvda)

INTO(data-area)

INTO options

REMFLENGTH(data-area)

RESPSTATUS(cvda)

SEQNUMIN(data-area)

SEQNUMOUT(data-area)

TIMEOUT(data-value)

INTO options:

MAXFLENGTH(data-value)

FLENGTH(data-area)

Conditions: INVREQ

Chapter 6. FEPI command reference

241

FEPI programming

FEPI RECEIVE FORMATTED


FEPI RECEIVE FORMATTED CONVID(data-value) INTO(data-area) INTO options

ALARMSTATUS(cvda)

COLUMNS(data-area)

CURSOR(data-area)

ENDSTATUS(cvda)

FIELDS(data-area)

LINES(data-area)

RESPSTATUS(cvda)

TIMEOUT(data-value)

INTO options:

MAXFLENGTH(data-value)

FLENGTH(data-area)

Conditions: INVREQ

FEPI REQUEST PASSTICKET


FEPI REQUEST PASSTICKET(data-area) CONVID(data-value) ESMRESP(data-area)

ESMREASON(data-area)

Conditions: INVREQ

FEPI SEND DATASTREAM


FEPI SEND DATASTREAM CONVID(data-value) FROM(data-value) FLENGTH(data-value)

INVITE

FMH

SEQNUMIN(data-area)

SEQNUMOUT(data-area)

Conditions: INVREQ

242

CICS TS for z/OS: CICS Users Handbook

FEPI programming

FEPI SEND FORMATTED


FEPI SEND FORMATTED CONVID(data-value) FROM(data-value) FLENGTH(data-value) AID(data-value) CURSOR(data-value) KEYSTROKES ESCAPE(data-value)

Conditions: INVREQ

FEPI START
FEPI START CONVID(data-value) TRANSID(data-value) TERMID(data-value)

USERDATA(data-value) FLENGTH(data-value)

TIMEOUT(data-value)

Conditions: INVREQ

FEPI system programming

FEPI ADD POOL


ACQUIRED FEPI ADD POOL(data-value) ACQSTATUS(cvda) RELEASED INSERVICE SERVSTATUS(cvda) OUTSERVICE TARGETLIST(data-area) TARGETNUM(data-value) NODELIST(data-area) NODENUM(data-value)

Conditions:: INVREQ, NOTAUTH

Chapter 6. FEPI command reference

243

FEPI programming

FEPI DELETE POOL


FEPI DELETE POOL(data-value) NODELIST(data-area) NODENUM(data-value)

TARGETLIST(data-area) TARGETNUM(data-value)

Conditions:: INVREQ, NOTAUTH

FEPI DISCARD NODELIST


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

Conditions:: INVREQ, NOTAUTH

FEPI DISCARD POOL


FEPI DISCARD POOL(data-value)

Conditions:: INVREQ, NOTAUTH

FEPI DISCARD PROPERTYSET


FEPI DISCARD PROPERTYSET(data-value)

Conditions:: INVREQ, NOTAUTH

FEPI DISCARD TARGETLIST


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

Conditions:: INVREQ, NOTAUTH

244

CICS TS for z/OS: CICS Users Handbook

FEPI programming

FEPI INQUIRE CONNECTION


FEPI INQUIRE CONNECTION NODE(data-value) TARGET(data-value) ACQNUM(data-area)

ACQSTATUS(cvda)

CONVNUM(data-area)

INSTLSTATUS(cvda)

LASTACQCODE(data-area)

POOL(data-area)

SERVSTATUS(cvda)

STATE(cvda)

USERDATA(data-area)

WAITCONVNUM(data-area)

Conditions:: END, ILLOGIC, INVREQ, NOTAUTH

FEPI INQUIRE NODE


FEPI INQUIRE NODE(data-value) ACQNUM(data-area) ACQSTATUS(cvda)

INSTLSTATUS(cvda)

LASTACQCODE(data-area)

SERVSTATUS(cvda)

USERDATA(data-area)

Conditions:: END, ILLOGIC, INVREQ, NOTAUTH

Chapter 6. FEPI command reference

245

FEPI programming

FEPI INQUIRE POOL


FEPI INQUIRE POOL(data-value) BEGINSESSION(data-area) CONTENTION(cvda)

DEVICE(cvda)

ENDSESSION(data-area)

EXCEPTIONQ(data-area)

FJOURNALNUM(data-area)

FORMAT(cvda)

INITIALDATA(cvda)

INSTLSTATUS(cvda)

MAXFLENGTH(data-area)

MSGJRNL(cvda)

PROPERTYSET(data-area)

SERVSTATUS(cvda)

STSN(data-area)

UNSOLDATA(data-area)

UNSOLDATACK(cvda)

USERDATA(data-area)

WAITCONVNUM(data-area)

Conditions:: END, ILLOGIC, INVREQ, NOTAUTH

FEPI INQUIRE PROPERTYSET


FEPI INQUIRE PROPERTYSET(data-value) BEGINSESSION(data-area) CONTENTION(cvda)

DEVICE(cvda)

ENDSESSION(data-area)

EXCEPTIONQ(data-area)

FJOURNALNUM(data-area)

FORMAT(cvda)

INITIALDATA(cvda)

MAXFLENGTH(data-area)

MSGJRNL(cvda)

STSN(data-area)

UNSOLDATA(data-area)

UNSOLDATACK(cvda)

Conditions:: END, ILLOGIC, INVREQ, NOTAUTH

FEPI INQUIRE TARGET


FEPI INQUIRE TARGET(data-value) APPL(data-area) INSTLSTATUS(cvda)

SERVSTATUS(cvda)

USERDATA(data-area)

Conditions:: END, ILLOGIC, INVREQ, NOTAUTH

246

CICS TS for z/OS: CICS Users Handbook

FEPI programming

FEPI INSTALL NODELIST


ACQUIRED FEPI INSTALL NODELIST(data-area) NODENUM(data-value) ACQSTATUS(cvda) RELEASED INSERVICE PASSWORDLIST(data-area) SERVSTATUS(cvda) OUTSERVICE

Conditions:: INVREQ, NOTAUTH

FEPI INSTALL POOL


ACQUIRED FEPI INSTALL POOL(data-value) PROPERTYSET(data-value) ACQSTATUS(cvda) RELEASED INSERVICE NODELIST(data-area) NODENUM(data-value) SERVSTATUS(cvda) OUTSERVICE

TARGETLIST(data-area) TARGETNUM(data-value)

Conditions:: INVREQ, NOTAUTH

Chapter 6. FEPI command reference

247

FEPI programming

FEPI INSTALL PROPERTYSET


LOSE FEPI INSTALL PROPERTYSET(data-value) BEGINSESSION(data-value) CONTENTION(cvda) WIN

T3278M2 DEVICE(cvda) T3278M3 T3278M4 T3278M5 T3279M2 T3279M3 T3279M4 T3279M5 TPS55M2 TPS55M3 TPS55M4 LUP ENDSESSION(data-value) EXCEPTIONQ(data-value)

FORMATTED FJOURNALNUM(data-value) FORMAT(cvda) DATASTREAM NOMSGJRNL MAXFLENGTH(data-value) MSGJRNL(cvda) INPUT OUTPUT INOUT

NOTINBOUND INITIALDATA(cvda) INBOUND

STSN(data-value)

UNSOLDATA(data-value)

NEGATIVE UNSOLDATACK(cvda) POSITIVE

Conditions:: INVREQ, NOTAUTH

248

CICS TS for z/OS: CICS Users Handbook

FEPI programming

FEPI INSTALL TARGETLIST


FEPI INSTALL TARGETLIST(data-area) APPLLIST(data-area) TARGETNUM(data-value)

INSERVICE SERVSTATUS(cvda) OUTSERVICE

Conditions:: INVREQ, NOTAUTH

FEPI SET CONNECTION


FEPI SET CONNECTION NODE(data-value) NODELIST(data-area) NODENUM(data-value)

TARGET(data-value) TARGETLIST(data-area) TARGETNUM(data-value)

ACQSTATUS(cvda) ACQUIRED RELEASED

SERVSTATUS(cvda) INSERVICE OUTSERVICE

USERDATA(data-value)

Conditions:: INVREQ, NOTAUTH

FEPI SET NODE


FEPI SET NODE(data-value) NODELIST(data-area) NODENUM(data-value)

ACQSTATUS(cvda) ACQUIRED RELEASED

SERVSTATUS(cvda) INSERVICE OUTSERVICE

USERDATA(data-value)

Conditions:: INVREQ, NOTAUTH

Chapter 6. FEPI command reference

249

FEPI programming

FEPI SET POOL


FEPI SET POOL(data-value) POOLLIST(data-area) POOLNUM(data-value)

SERVSTATUS(cvda) INSERVICE OUTSERVICE

USERDATA(data-value)

Conditions:: INVREQ, NOTAUTH

FEPI SET TARGET


FEPI SET TARGET(data-value) TARGETLIST(data-area) TARGETNUM(data-value)

SERVSTATUS(cvda) INSERVICE OUTSERVICE

USERDATA(data-value)

Conditions:: INVREQ, NOTAUTH

FEPI SP NOOP
FEPI SP NOOP

Conditions:: INVREQ, NOTAUTH

250

CICS TS for z/OS: CICS Users Handbook

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


This chapter contains General-use Programming Interface information. 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.

Using the tables The section consists of three tables. The first, beginning below, is in character sequence of the CVDA values. The second, beginning on page 264, is in numeric sequence. The third, beginning on page 278, gives the CVDA values returned by the INQUIRE TERMINAL|NETNAME DEVICE command.

CVDAs and numeric values in alphabetic sequence


CVDA AAUXDS ABEND ACQFAIL ACQUIRED ACQUIRING ACTIVE ACTIVITY ADD ADDABLE ADDFAIL ADVANCE AINIT ALARM ALLCONN ALLOCTD ALLQUERY ALTERABLE ALTERNATE ALTPRTCOPY AND ANY APLKYBD APLTEXT APPC APPCPARALLEL APPCSINGLE APPEND APPLICATION ASACTL ASCII7 ASCII8 ASSEMBLER ATI ATTENTION AUDALARM
Copyright IBM Corp. 1989, 2002

DecValueHexValue 315 13B 900 384 515 203 69 45 71 48 181 B5 1002 3EA 291 123 41 29 519 207 265 109 282 11A 501 1F5 169 A9 81 51 431 1AF 52 34 197 C5 446 1BE 1005 3ED 158 9E 391 187 393 198 124 7C 374 176 373 175 1036 40C 559 22F 224 E0 616 268 617 267 150 96 75 4B 524 20C 395 18B

251

CVDA
CVDA AUTOACTIVE AUTOARCH AUTOAUTH AUTOCONN AUTOINACTIVE AUTOINIT AUTOPAGE AUTOREGISTER AUTOSTART AUXILIARY AUXPAUSE AUXSTART AUXSTOP AVAILABLE BACKOUT BACKTRANS BACKUPNONBWO BASE BASEAPI BASESPACE BASICAUTH BAUXDS BDAM BEGINSESSION BELOW BGAM BINARY BINIT BLK BLOCKED BOTH BROWSABLE BSAM BTAM BUSY C CACHE CANCEL CANCELLED CANCELLING CD CEDF CERTIFICAUTH CFTABLE CGROUP CICS CICSDATAKEY CICSECURITY CICSEXECKEY CICSTABLE CKOPEN CLEAR CLIENT CLIENTAUTH DecValueHexValue 630 276 262 106 1095 447 170 AA 631 277 284 11C 80 50 1094 446 618 26A 247 F7 313 139 312 138 314 13A 95 5F 192 C0 397 18D 800 320 10 A 1052 41C 664 298 1092 444 316 13C 2 2 510 1FE 159 9F 63 3F 1038 40E 283 11B 47 2F 16 10 1100 44C 39 27 61 3D 62 3E 612 264 149 95 791 317 526 20E 624 270 1025 401 491 1EB 370 172 1093 445 833 341 902 386 660 294 379 17B 195 C3 381 17D 101 65 1055 41F 640 280 741 2E5 1032 408

252

CICS TS for z/OS: CICS Users Handbook

CVDA
CVDA CLIENTCERT CLOSED CLOSEFAILED CLOSELEAVE CLOSEREQ CLOSING CMDPROT CMDSECEXT CMDSECNO CMDSECYES COBOL COBOLII COLD COLDACQ COLDQUERY COLDSTART COLOR COMMIT COMMITFAIL COMPLETE COMPOSITE CONFFREE CONFRECV CONFSEND CONNECT CONNECTED CONNECTING CONNECTION CONSISTENT CONSOLE CONTENTION CONTROLSHUT CONVERSE CONVIDLE COORDINATOR COPID COPY CORBA CPLUSPLUS CREATE CRITICAL CSIGN CTERM CTLGALL CTLGMODIFY CTLGNONE CTRLABLE CTX CURRENT CUSERID DAEOPT DATA DATASET DATASETFULL DecValueHexValue 1087 43F 19 13 349 15B 261 105 22 16 21 15 673 2A1 207 CF 205 CD 207 CF 151 97 375 177 788 314 72 48 433 1B1 266 10A 399 18F 208 D0 792 318 1026 402 1003 3EB 82 52 83 53 84 54 903 387 690 2B2 904 388 755 2F3 723 2D3 66 42 836 344 623 26F 600 258 518 206 770 302 908 38C 401 191 1101 44D 148 94 67 43 11 B 905 389 906 38A 632 278 633 279 634 27A 56 38 907 38B 260 104 909 38D 684 2AC 508 1FC 756 2F4 793 319

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

253

CVDA
CVDA DATASTREAM DEADLOCK DEBUG DEC DEFAULT DEFRESP1 DEFRESP1OR2 DEFRESP2 DEFRESP3 DELAY DELETABLE DELETE DELETEFAIL DELEXITERROR DEREGERROR DEREGISTERED DEST DISABLED DISABLING DISCARDFAIL DISCARDING DISCONNING DISCREQ DISK1 DISK2 DISK2PAUSE DISPATCHABLE DORMANT DPLSUBSET DS3270 DUALCASE DUMMY DYNAMIC EB EBCDIC EJB EMERGENCY EMPTY EMPTYREQ ENABLED ENDAFFINITY EQUAL ESDS EVENT EVENTUAL EXCEPT EXCEPTRESP EXCI EXCTL EXECENQ EXECENQADDR EXIT EXITTRACE EXPIRED DecValueHexValue 543 21F 794 31A 1082 43A 46 2E 198 C6 497 1F1 528 210 498 1F2 499 1F3 637 27D 43 2B 292 124 520 208 795 31B 679 2A7 678 2A6 235 EB 24 18 25 19 513 201 1118 45E 910 38E 444 1BC 252 FC 253 FD 254 FE 228 E4 1024 400 383 17F 615 267 403 193 781 30D 178 B2 490 1EA 1039 40F 1102 44E 268 10C 210 D2 31 1F 23 17 790 316 911 38F 5 5 334 14E 3 3 332 14C 523 20B 650 28A 48 30 751 2EF 752 2F0 912 390 362 16A 1017 3F9

254

CICS TS for z/OS: CICS Users Handbook

CVDA
CVDA EXTENDEDDS EXTRA EXTSECURITY FAILED FAILEDBKOUT FAILINGBKOUT FCLOSE FILE FINALQ FINPUT FIRED FIRSTINIT FIRSTQ FIXED FLUSH FMH FMHPARM FOPEN FORCE FORCECANCEL FORCECLOSE FORCED FORCEPURGE FORCLOSING FORMATEDF FORMATTED FORMFEED FOUTPUT FREE FREEING FULL FULLAPI FULLAUTO FWDRECOVABLE GENERIC GMT GOINGOUT GROUP GTFSTART GTFSTOP HEURBACKOUT HEURCOMMIT HEX HFORM HIGH HILIGHT HOLD HOME HOTPOOL HTTP HTTPNO HTTPYES IGNORE IGNORERR DecValueHexValue 405 195 221 DD 194 C2 782 30E 357 165 358 166 273 111 238 EB 183 B7 270 10E 1001 3E9 625 271 182 B6 12 C 783 30F 502 1F6 385 181 272 110 342 156 655 28F 351 15F 1013 3F5 237 ED 353 161 606 25E 542 21E 407 197 271 10F 85 55 94 5E 212 D4 384 180 1073 431 354 162 651 28B 604 25C 172 AC 913 391 317 13D 318 13E 758 2F6 757 2F5 45 2D 409 199 914 392 413 19D 163 A3 1103 44F 1065 429 1096 448 1034 40A 1033 409 1 1 816 330

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

255

CVDA
CVDA IIOP IMMCLOSE IMMCLOSING IMMEDIATE IMMQUIESCED INACTIVE INBOUND INCOMPLETE INDEXRECFULL INDIRECT INDOUBT INFLIGHT INITCOMPLETE INITIAL INITING INOUT INPUT INSERVICE INSTALLED INSTALLFAIL INTERNAL INTRA INTSTART INTSTOP INVALID IOERROR IRC ISOLATE JAVA JVM KATAKANA KEEP KEYED KSDS LCKSTRUCFULL LEAVE LE370 LIC LIGHTPEN LOAD LOCAL LOCKING LOG LOGICAL LOGTERM LOSE LOW LPA LUP LUSTAT LUW LU61 MAIN MAP DecValueHexValue 1097 449 350 15E 352 160 2 2 706 2C2 378 17A 547 223 1014 3F6 796 31C 122 7A 620 26C 621 25D 628 274 789 315 1112 458 532 214 226 E2 73 49 550 226 512 200 1058 422 222 DE 310 136 311 137 359 167 797 31D 121 79 658 292 147 93 1080 438 415 19F 786 312 8 8 6 6 832 340 811 32B 377 179 493 1ED 417 1A1 834 342 605 25D 837 345 54 36 216 D8 269 10D 544 220 915 393 165 A5 541 21D 525 20D 246 F6 125 7D 248 F8 155 9B

256

CICS TS for z/OS: CICS Users Handbook

CVDA
CVDA MAPSET MCHCTL MDT MOD MODEANY MODEL MODE24 MODE31 MORE MSRCONTROL MVS NEGATIVE NEW NEWCOPY NEWSESSION NOALARM NOALTPRTCOPY NOAPLKYBD NOAPLTEXT NOAPPEND NOATI NOAUDALARM NOAUTHENTIC NOAUTO NOAUTOARCH NOBACKOUT NOBACKTRANS NOCEDF NOCLEAR NOCMDPROT NOCOLOR NOCONNECT NOCONV NOCONVERSE NOCOPY NOCREATE NOCTL NODAEOPT NODEDUG NODISCREQ NODUALCASE NOEMPTYREQ NOEVENT NOEXCEPT NOEXCTL NOEXIT NOEXITTRACE NOEXTENDEDDS NOFMH NOFMHPARM NOFORCE NOFORMATEDF NOFORMFEED NOHFORM DecValueHexValue 155 9B 241 F1 506 1FA 813 32D 189 BD 370 172 190 BE 191 BF 492 1EC 419 1A3 780 30C 530 212 28 1CF 167 A7 485 1E5 500 1F4 447 1BF 392 188 394 18A 1037 40D 76 4C 396 18C 1091 443 1071 42F 263 107 193 C1 398 18E 371 173 641 281 674 2A2 400 190 916 394 556 22C 601 259 402 192 68 44 223 DF 685 2AD 1083 43B 445 1BD 404 194 32 20 335 14F 333 14D 49 31 917 395 363 16B 406 196 503 1F7 386 182 1054 41E 607 25F 408 198 410 19A

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

257

CVDA
CVDA NOHILIGHT NOHOLD NOISOLATE NOJVM NOKATAKANA NOKEEP NOLIGHTPEN NOLOAD NOLOG NOLOSTLOCKS NOMDT NOMSGJRNL NOMSRCONTROL NONAUTOCONN NONCRITICAL NONCICS NONE NONLE370 NOOBFORMAT NOOBOPERID NOOUTLINE NOPARTITIONS NOPERF NOPRESETSEC NOPRINTADAPT NOPROGSYMBOL NOPRTCOPY NOQUERY NORECOVDATA NOREENTPROT NORELEASE NORELREQ NORETAINED NORMAL NORMALBKOUT NORMALRESP NOROLLBACK NOSECURITY NOSHUTDOWN NOSOSI NOSPI NOSSL NOSTSN NOSWITCH NOSYNCPOINT NOSYSDUMP NOSYSLOG NOTADDABLE NOTALTERABLE NOTAPPLIC NOTASKSTART NOTBRWBLE NOTBUSY NOTCDEB DecValueHexValue 414 19E 164 A4 657 291 1081 439 416 1A0 787 313 418 1A2 835 343 55 37 710 2C6 507 1FB 531 213 420 1A4 171 AB 1090 442 661 295 496 1F0 1084 43C 422 1A6 388 184 424 1A8 426 1AA 331 14B 243 F3 428 1AC 430 1AE 449 1C1 432 1B0 700 2BC 681 2A9 918 396 443 1BB 711 2C7 1016 3F8 356 164 522 20A 919 397 196 C4 289 121 435 1B3 694 2B6 1031 407 487 1E7 285 11D 603 25B 185 B9 784 310 42 2A 53 35 1 1 608 260 40 28 613 265 495 1EF

258

CICS TS for z/OS: CICS Users Handbook

CVDA
CVDA NOTCONNECTED NOTCTRLABLE NOTDEFINED NOTDELBLE NOTDYNAMIC NOTEMPTY NOTERMINAL NOTEXTKYBD NOTEXTPRINT NOTFIRED NOTFWDRCVBLE NOHOTPOOL NOTINBOUND NOTINIT NOTINSTALLED NOTKEYED NOTLPA NOTPEND NOTPURGEABLE NOTRANDUMP NOTRANSEXCI NOTREADABLE NOTREADY NOTRECOVABLE NOTREQUIRED NOTRLS NOTROUTABLE NOTSOS NOTSUPPORTED NOTSUSPENDED NOTTABLE NOTTI NOTUPDBLE NOTWAIT NOUCTRAN NOUSER NOVALIDATION NOVFORM NOWAIT NOWRITE NOZCPTRACE NRS N906 N906D OBFORMAT OBOPERID OBTAINING OFF OK OLD OLDCOPY OLDSESSION ON OPEN DecValueHexValue 691 2B3 57 39 659 293 44 2C 1021 3FD 211 D3 214 D6 437 1B5 439 1B7 1000 3E8 361 169 1066 42A 546 222 376 178 551 227 9 9 166 A6 127 7F 161 A1 187 BB 1061 425 36 24 259 103 30 1E 667 29B 721 2D1 1022 3FE 669 29D 15 F 1027 403 100 64 78 4E 38 26 920 398 451 1C3 1011 3F3 441 1B9 412 19C 341 155 275 113 365 16D 774 306 931 3A3 921 399 421 1A5 387 183 96 60 200 C8 274 112 26 1A 162 A2 486 1E6 201 C9 18 12

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

259

CVDA
CVDA OPENAPI OPENERROR OPENING OPENINPUT OPENOUTPUT OPID OR OTS OTSCOORD OUTLINE OUTPUT OUTSERVICE OWNER PAGEABLE PARTITIONS PARTNSET PATH PDSMEMBER PENDBEGIN PENDDATA PENDFREE PENDING PENDINIT PENDPASS PENDRECV PENDRELEASE PENDRESOLVE PENDSTART PENDSTSN PENDUNSOL PERF PHASEIN PHYSICAL PLI PL1 POOL POSITIVE POST PRESETSEC PRIMARY PRINTADAPT PRIVATE PROCESS PROFILE PROGAUTO PROGRAM PROGSYMBOL PROTECTED PRTCOPY PUBLISH PURGE PURGEABLE QR QUASIRENT DecValueHexValue 1053 41D 798 31E 20 14 256 100 257 101 933 3A5 1006 3EE 1107 453 1108 454 423 1A7 227 E3 74 4A 753 2F1 79 4F 425 1A9 156 9C 11 B 1035 40B 558 22E 560 230 86 56 126 7E 1113 459 565 235 87 57 562 232 1114 45A 561 231 557 22D 564 234 330 14A 168 A8 215 D7 152 98 152 98 922 39A 529 211 636 27C 242 F2 110 6E 427 1AB 174 AE 1010 3F2 157 9D 1072 430 154 9A 429 1AD 504 1F8 448 1C0 1085 43D 236 EC 160 A0 1057 421 1050 41A

260

CICS TS for z/OS: CICS Users Handbook

CVDA
CVDA QUEUE QUIESCED QUIESCING READABLE READBACK READONLY READY REBUILD RECEIVE RECONNECT RECOVDATA RECOVERABLE RECOVERED RECOVERLOCKS REENTPROT REGERROR REGISTERED REJECT RELATED RELEASE RELEASED RELEASING RELREQ REMLOSTLOCKS REMOTE REMOVE REMSESSION REMTABLE REPEATABLE REQUIRED REREAD RESET RESETLOCKS RESOLVING RESSECEXT RESSECINT RESSECNO RESSECYES RESYNC RETAINED RETRACT RETRY REVERTED RLS RLSACTIVE RLSGONE RLSINACTIVE RLSSERVER RMI ROLLBACK ROUTABLE ROUTE RPG RRCOMMITFAIL DecValueHexValue 814 32E 707 2C3 708 2C4 35 23 209 D1 275 113 258 102 923 39B 88 58 924 39C 701 2BD 29 1D 277 115 712 2C8 680 2A8 677 2A5 670 29E 815 32F 675 2A3 563 233 70 46 549 225 442 1BA 713 2C9 4 4 276 114 740 2E4 103 67 724 2D4 666 29A 812 32C 290 122 714 2CA 1115 45B 204 CC 203 CB 202 CA 204 CC 702 2BE 715 2CB 1086 43E 716 2CC 264 108 720 2D0 730 2DA 799 31F 731 2DB 761 2F9 771 303 89 59 1023 3FF 638 27E 153 99 830 33E

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

261

CVDA
CVDA RRDS RRINDOUBT RRMS RTR RU RUNNING SCS SECONDINIT SEND SESSION SESSIONFAIL SESSIONLOST SETFAIL SHARE 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 DecValueHexValue 7 7 831 33F 1062 426 527 20F 494 1EE 229 E5 614 266 626 272 90 5A 372 174 517 205 516 204 514 202 27 1B 173 AD 762 2FA 645 285 288 120 644 284 925 39D 245 F5 244 F4 324 144 323 143 810 32A 255 FF 668 29C 683 2AB 682 2AA 434 1B2 652 28C 177 B1 693 2B5 175 AF 926 39E 1030 406 629 275 176 B0 635 27B 609 261 772 304 180 B4 179 B3 610 262 509 1FD 488 1E8 489 1E9 773 305 663 297 371 173 231 E7 188 BC 287 11F 225 E1

262

CICS TS for z/OS: CICS Users Handbook

CVDA
CVDA SWITCHNEXT SYNCFREE SYNCPOINT SYNCRECV SYNCSEND SYSDUMP SYSLOG SYSTEM SYSTEMOFF SYSTEMON TAKEOVER TAPE1 TAPE2 TASK TASKSTART TCAM TCAMSNA TCEXITALL TCEXITALLOFF TCEXITNONE TCEXITSYSTEM TCLASS TDQ TERM TERMINAL TEXTKYBD TEXTPRINT THIRDINIT THREADSAFE TIME TIMEOUT TIMER TPOOL TPS55M2 TPS55M3 TPS55M4 TPS55M5 TRANDUMP TRANIDONLY TRANSEXCI TSQ TTI TWAIT TX TXID T3278M2 T3278M3 T3278M4 T3278M5 T3279M2 T3279M3 T3279M4 T3279M5 UCTRAN DecValueHexValue 286 11E 91 5B 602 25A 92 5C 93 5D 184 B8 785 311 643 283 320 140 319 13F 111 6F 250 FA 251 FB 233 E9 611 263 64 40 65 41 366 16E 369 171 368 170 367 16F 239 EF 767 2FF 234 EA 213 D5 436 1B4 438 1B6 627 273 1051 41B 240 F0 511 1FF 1004 3EC 932 3A4 552 228 553 229 554 22A 555 22B 186 BA 452 1C4 1060 424 768 300 77 4D 927 39F 929 3A1 928 3A0 533 215 534 216 535 217 536 218 537 219 538 21A 539 21B 540 21C 450 1C2

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

263

CVDA
CVDA UKOPEN UNATTEMPTED UNAVAILABLE UNBLOCKED UNCOMMITTED UNCONNECTED UNDEFINED UNDETERMINED UNENABLED UNENABLING UNEXPIRED UNKNOWN UNPROTECTED UNQUIESCED UNREGISTERED UNRESOLVED UNSOLDATA UNUSABLE UOW UPDATABLE USER USERDATAKEY USEREXECKEY USERID USEROFF USERON USERTABLE VALID VALIDATION VARIABLE VFORM VRRDS VSAM VTAM WAIT WAITCOMMIT WAITER WAITFORGET WAITING WAITRMI WAITRRMS WARMSTART WIN XCF XM XNOTDONE XOK ZCPTRACE DecValueHexValue 1056 420 820 334 672 2A0 17 11 722 2D2 703 2BF 14 E 355 163 33 21 34 22 1018 3FA 774 306 505 1F9 709 2C5 671 29F 1116 45C 521 209 1117 45D 246 F6 37 25 642 282 380 17C 382 17E 930 3A2 322 142 321 141 102 66 360 168 440 1B8 13 D 411 19B 732 2DC 3 3 60 3C 340 154 763 2FB 754 2F2 622 26E 765 2FD 766 2FE 1063 427 267 10B 545 221 665 299 123 7B 144 90 143 8F 364 16C

CVDAs and numeric values in numeric sequence


DecValueHexValue 1 1 CVDA IGNORE

264

CICS TS for z/OS: CICS Users Handbook

CVDA
DecValueHexValue 1 1 2 2 3 3 4 4 5 5 6 6 7 7 8 8 9 9 10 A 11 B 11 B 12 C 13 D 14 E 15 F 16 10 17 11 18 12 19 13 20 14 21 15 22 16 23 17 24 18 25 19 26 1A 27 1B 28 1C 29 1D 30 1E 31 1F 32 20 33 21 34 22 35 23 36 24 37 25 38 26 39 27 40 28 41 29 42 2A 43 2B 44 2C 45 2D 46 2E 47 2F 48 30 49 31 52 34 53 35 54 36 55 37 CVDA NOTAPPLIC BDAM VSAM REMOTE ESDS KSDS RRDS KEYED NOTKEYED BASE CRITICAL PATH FIXED VARIABLE UNDEFINED NOTSUPPORTED BLOCKED UNBLOCKED OPEN CLOSED OPENING CLOSING CLOSEREQUEST ENABLED DISABLED DISABLING OLD SHARE NEW RECOVERABLE NOTRECOVABLE EMPTYREQ NOEMPTYREQ UNENABLED UNENABLING READABLE NOTREADABLE UPDATABLE NOTUPDATABLE BROWSABLE NOTBROWSABLE ADDABLE NOTADDABLE DELETABLE NOTDELETABLE HEX DEC BLK EXCTL NOEXCTL ALTERABLE NOTALTERABLE LOG NOLOG

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

265

CVDA
DecValueHexValue 56 38 57 39 60 3C 60 3C 61 3D 62 3E 63 3F 64 40 65 41 66 42 67 43 68 44 69 45 70 46 71 47 72 48 73 49 74 4A 75 4B 76 4C 77 4D 78 4E 79 4F 80 50 81 51 82 52 83 53 84 54 85 55 86 56 87 57 88 58 89 59 90 5A 91 5B 92 5C 93 5D 94 5E 95 5F 96 60 100 64 101 65 102 66 103 67 110 6E 111 6F 121 79 122 7A 123 7B 124 7C 125 7D 126 7E 127 7F 143 8F CVDA CTRLABLE NOTCTRLABLE SNA 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 NOTTABLE CICSTABLE USERTABLE REMTABLE PRIMARY TAKEOVER IRC INDIRECT XM APPC LU61 PENDING NOTPENDING XOK

266

CICS TS for z/OS: CICS Users Handbook

CVDA
DecValueHexValue 144 90 147 93 148 94 149 95 150 96 151 97 152 98 152 98 153 99 154 9A 155 9B 155 9B 156 9C 157 9D 158 9E 159 9F 160 A0 161 A1 162 A2 163 A3 164 A4 165 A5 166 A6 167 A7 168 A8 169 A9 170 AA 171 AB 172 AC 173 AD 174 AE 175 AF 176 B0 177 B1 178 B2 179 B3 180 B4 181 B5 182 B6 183 B7 184 B8 185 B9 186 BA 187 BB 188 BC 189 BD 190 BE 191 BF 192 C0 193 C1 194 C2 195 C3 196 C4 197 C5 CVDA XNOTDONE JAVA CPLUSPLUS C ASSEMBLER COBOL PLI PL1 RPG PROGRAM MAP MAPSET PARTITIONSET PROFILE ANY BELOW PURGEABLE NOTPURGEABLE OLDCOPY HOLD NOHOLD LPA NOTLPA NEWCOPY PHASEIN ALLCONN AUTOCONN NONAUTOCONN GOINGOUT SHARED PRIVATE SPRSTRACE STANTRACE SPECTRACE DYNAMIC STATIC STARTUP ACTIVE FIRSTQUIESCE FINALQUIESCE SYSDUMP NOSYSDUMP TRANDUMP NOTRANDUMP SWITCH MODEANY MODE24 MODE31 BACKOUT NOBACKOUT EXTSECURITY CICSSECURITY NOSECURITY ALTERNATE

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

267

CVDA
DecValueHexValue 198 C6 200 C8 201 C9 202 CA 203 CB 204 CC 204 CC 205 CD 207 CF 207 CF 208 D0 209 D1 210 D2 211 D3 212 D4 213 D5 214 D6 215 D7 216 D8 221 DD 222 DE 223 DF 224 E0 225 E1 226 E2 227 E3 228 E4 229 E5 231 E7 233 E9 234 EA 235 EB 236 EC 237 ED 238 EE 239 EF 240 F0 241 F1 242 F2 243 F3 244 F4 245 F5 246 F6 246 F6 247 F7 248 F8 250 FA 251 FB 252 FC 253 FD 254 FE 255 FF 256 100 257 101 CVDA DEFAULT OFF ON RESSECNO RESSECINT RESSECYES RESSECEXT CMDSECNO CMDSECEXT 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 FILE TCLASS TIME MCHCTL PRESETSEC NOPRESETSEC SIGNEDON SIGNEDOFF LUW UOW AUXILIARY MAIN TAPE1 TAPE2 DISK1 DISK2 DISK2PAUSE SMF OPENINPUT OPENOUTPUT

268

CICS TS for z/OS: CICS Users Handbook

CVDA
DecValueHexValue 258 102 259 103 260 104 261 105 262 106 263 107 264 108 265 109 266 10A 267 10B 268 10C 269 10D 270 10E 271 10F 272 110 273 111 274 112 275 113 275 113 276 114 277 115 282 11A 283 11B 284 11C 285 11D 286 11E 287 11F 288 120 289 121 290 122 291 123 292 124 310 136 311 137 312 138 313 139 314 13A 317 13D 318 13E 319 13F 320 140 321 141 322 142 323 143 324 144 330 14A 331 14B 332 14C 333 14D 334 14E 335 14F 340 154 341 155 342 156 CVDA READY NOTREADY CURRENT CLOSELEAVE AUTOARCH NOAUTOARCH REVERTED ADVANCE COLDSTART WARMSTART EMERGENCY LOGTERM FINPUT FOUTPUT FOPEN FCLOSE OK NOWRITE READONLY REMOVE RECOVERED AINIT BINIT AUTOINIT NOSWITCH SWITCHNEXT SWITCHALL SHUTDOWN NOSHUTDOWN RESET ADD DELETE INTSTART INTSTOP AUXSTART AUXPAUSE AUXSTOP GTFSTART GTFSTOP SYSTEMON SYSTEMOFF USERON USEROFF SINGLEON SINGLEOFF PERF NOPERF EXCEPT NOEXCEPT EVENT NOEVENT WAIT NOWAIT FORCE

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

269

CVDA
DecValueHexValue 349 15D 350 15E 351 15F 352 160 353 161 354 162 355 163 356 164 357 165 358 166 359 167 360 168 361 169 362 16A 363 16B 364 16C 365 16D 366 16E 367 16F 368 170 369 171 370 172 370 172 371 173 371 173 372 174 373 175 374 176 375 177 376 178 377 179 378 17A 379 17B 380 17C 381 17D 382 17E 383 17F 384 180 385 181 386 182 387 183 388 184 391 187 392 188 393 189 394 18A 395 18B 396 18C 397 18D 398 18E 399 18F 400 190 401 191 402 192 CVDA CLOSEFAILED 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 DPLSUBSET FULLAPI FMHPARM NOFMHPARM OBOPERID NOOBOPERID APLKYBD NOAPLKYBD APLTEXT NOAPLTEXT AUDALARM NOAUDALARM BACKTRANS NOBACKTRANS COLOR NOCOLOR COPY NOCOPY

270

CICS TS for z/OS: CICS Users Handbook

CVDA
DecValueHexValue 403 193 404 194 405 195 406 196 407 197 408 198 409 199 410 19A 411 19B 412 19C 413 19D 414 19E 415 19F 416 1A0 417 1A1 418 1A2 419 1A3 420 1A4 421 1A5 422 1A6 423 1A7 424 1A8 425 1A9 426 1AA 427 1AB 428 1AC 429 1AD 430 1AE 431 1AF 432 1B0 433 1B1 434 1B2 435 1B3 436 1B4 437 1B5 438 1B6 439 1B7 440 1B8 441 1B9 442 1BA 443 1BB 444 1BC 445 1BD 446 1BE 447 1BF 448 1C0 449 1C1 450 1C2 451 1C3 452 1C4 485 1E5 486 1E6 487 1E7 488 1E8 CVDA 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 COLDQUERY SOSI NOSOSI TEXTKYBD NOTEXTKYBD TEXTPRINT NOTEXTPRINT VALIDATION NOVALIDATION RELREQ NORELREQ DISCREQ NODISCREQ ALTPRTCOPY NOALTPRTCOPY PRTCOPY NOPRTCOPY UCTRAN NOUCTRAN TRANIDONLY NEWSESSION OLDSESSION NOSTSN STSNSET

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

271

CVDA
DecValueHexValue 489 1E9 490 1EA 491 1EB 492 1EC 493 1ED 494 1EE 495 1EF 496 1F0 497 1F1 498 1F2 499 1F3 500 1F4 501 1F5 502 1F6 503 1F7 504 1F8 505 1F9 506 1FA 507 1FB 508 1FC 509 1FD 510 1FE 511 1FF 512 200 513 201 514 202 515 203 516 204 517 205 518 206 519 207 520 208 521 209 522 20A 523 20B 524 20C 525 20D 526 20E 527 20F 528 210 529 211 530 212 531 213 532 214 533 215 534 216 535 217 536 218 537 219 538 21A 539 21B 540 21C 541 21D 542 21E CVDA STSNTEST EB CD MORE LIC RU NOTCDEB NONE DEFRESP1 DEFRESP2 DEFRESP3 NOALARM ALARM FMH NOFMH PROTECTED UNPROTECTED MDT NOMDT DATA STSN BEGINSESSION TIMEOUT INSTALLFAIL 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

272

CICS TS for z/OS: CICS Users Handbook

CVDA
DecValueHexValue 543 21F 544 220 545 221 546 222 547 223 549 225 550 226 551 227 552 228 553 229 554 22A 555 22B 556 22C 557 22D 558 22E 559 22F 560 230 561 231 562 232 563 233 564 234 565 235 600 258 601 259 602 25A 603 25B 604 25C 605 25D 606 25E 607 25F 608 260 609 261 610 262 611 263 612 264 613 265 614 266 615 267 616 268 617 269 618 26A 620 26C 621 26D 622 26E 623 26F 624 270 625 271 626 272 627 273 628 274 629 275 630 276 631 277 632 278 CVDA DATASTREAM LOSE WIN NOTINBOUND INBOUND RELEASING INSTALLED NOTINSTALLED TPS55M2 TPS55M3 TPS55M4 TPS55M5 NOCONV PENDSTSN PENDBEGIN APPLICATION PENDDATA PENDSTART 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

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

273

CVDA
DecValueHexValue 633 279 634 27A 635 27B 636 27C 637 27D 638 27E 640 280 641 281 642 282 643 283 644 284 645 285 650 28A 651 28B 652 28C 653 28D 655 28F 657 291 658 292 659 293 660 294 661 295 663 297 664 298 665 299 666 29A 667 29B 668 29C 669 29D 670 29E 671 29F 672 2A0 673 2A1 674 2A2 675 2A3 677 2A5 678 2A6 679 2A7 680 2A8 681 2A9 682 2AA 683 2AB 684 2AC 685 2AD 690 2B2 691 2B3 693 2B5 694 2B6 700 2BC 701 2BD 702 2BE 703 2BF 706 2C2 707 2C3 CVDA CTLGMODIFY CTLGNONE START POST DELAY ROUTE CLEAR NOCLEAR USER SYSTEM SHUTENABLED SHUTDISABLED EXCI GENERIC SPECIFIC SYSCONNECT 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

274

CICS TS for z/OS: CICS Users Handbook

CVDA
DecValueHexValue 708 2C4 709 2C5 710 2C6 711 2C7 712 2C8 713 2C9 714 2CA 715 2CB 716 2CC 720 2D0 721 2D1 722 2D2 723 2D3 724 2D4 730 2DA 731 2DB 732 2DC 740 2E4 741 2E5 751 2EF 752 2F0 753 2F1 754 2F2 755 2F3 756 2F4 757 2F5 758 2F6 761 2F9 762 2FA 763 2FB 765 2FD 766 2FE 767 2FF 768 300 770 302 771 303 772 304 773 305 774 306 774 306 780 30C 781 30D 782 30E 783 30F 784 310 785 311 786 312 787 313 788 314 789 315 790 316 791 317 792 318 793 319 CVDA QUIESCING UNQUIESCED NOLOSTLOCKS NORETAINED RECOVERLOCKS REMLOSTLOCKS RESETLOCKS RETAINED RETRY RLS NOTRLS UNCOMMITTED CONSISTENT REPEATABLE RLSACTIVE RLSINACTIVE VRRDS REMSESSION CLIENT EXECENQ EXECENQADDR OWNER WAITER CONNECTION DATASET HEURCOMMIT HEURBACKOUT RLSSERVER SHUNTED WAITCOMMIT WAITING WAITRMI TDQ TSQ COORDINATOR RMI STARTING SUBORDINATE NRS UNKNOWN MVS DUMMY FAILED FLUSH NOSYSLOG SYSLOG KEEP NOKEEP COLD INITIAL ENDAFFINITY CACHE COMMITFAIL DATASETFULL

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

275

CVDA
DecValueHexValue 794 31A 795 31B 796 31C 797 31D 798 31E 799 31F 800 320 810 32A 811 32B 812 32C 813 32D 814 32E 815 32F 816 330 820 334 830 33E 831 33F 832 340 833 341 834 342 835 343 836 344 837 345 900 384 902 386 903 387 904 388 905 389 906 38A 907 38B 908 38C 909 38D 910 38E 911 38F 912 390 913 391 914 392 915 393 916 394 917 395 918 396 919 397 920 398 921 399 922 39A 923 39B 924 39C 925 39D 926 39E 927 39F 928 3A0 929 3A1 930 3A2 931 3A3 CVDA DEADLOCK DELEXITERROR INDEXRECFULL IOERROR OPENERROR RLSGONE BACKUPNONBWO SKIP 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 TXID TX USERID N906

276

CICS TS for z/OS: CICS Users Handbook

CVDA
DecValueHexValue 932 3A4 933 3A5 1000 3E8 1001 3E9 1002 3EA 1003 3EB 1004 3EC 1005 3ED 1006 3EE 1010 3F2 1011 3F3 1013 3F5 1014 3F6 1016 3F8 1017 3F9 1018 3FA 1021 3FD 1022 3FE 1023 3FF 1024 400 1025 401 1026 402 1027 403 1030 406 1031 407 1032 408 1033 409 1034 40A 1035 40b 1036 40C 1037 40D 1038 40E 1039 40F 1050 41A 1051 41B 1052 41C 1053 41D 1054 41E 1055 41F 1056 420 1057 421 1058 422 1060 424 1061 425 1062 426 1063 427 1065 429 1066 42A 1071 42F 1072 430 1073 431 1080 438 1081 439 1082 43A CVDA TPOOL OPID NOTFIRED FIRED ACTIVITY COMPOSITE TIMER AND OR PROCESS NOUSER FORCED INCOMPLETE NORMAL EXPIRED UNEXPIRED NOTDYNAMIC NOTROUTABLE ROUTABLE DORMANT CANCELLING COMPLETE NOTSUSPENDED SSL NOSSSL CLIENTAUTH HTTPYES HTTPNO PDSMEMBER APPEND NOAPPEND BINARY EBCDIC QUASIRENT THREADSAFE BASEAPI OPENAPI NOFORCE CKOPEN UKOPEN QR INTERNAL TRANSEXCI NOTRANSEXCI RRMS WAITRRMS HOTPOOL NOHOTPOOL NOAUTO PROGAUTO FULLAUTO JVM NOJVM DEBUG

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

277

CVDA
DecValueHexValue 1083 43B 1084 43C 1085 43D 1086 43E 1087 43F 1090 442 1091 443 1092 444 1093 445 1094 446 1095 447 1096 448 1097 449 1100 44C 1101 44D 1102 44E 1103 44F 1107 453 1108 454 1111 457 1112 458 1113 459 1114 45A 1115 45B 1116 45C 1117 45D 1118 45E CVDA NODEBUG NONLE370 PUBLISH RETRACT CLIENTCERT NONCRITICAL NOAUTHENTIC BASICAUTH CERTIFICAUTH AUTOREGISTER AUTOAUTH HTTP IIOP BOTH CORBA EJB HOME OTS OTSCOORD PHASEOUT INITING PENDINIT PENDRESOLVE RESOLVING UNRESOLVED UNUSABLE DISCARDING

CVDAs returned by the INQ NETNAME|TERMINAL DEVICE command


In alphabetic sequenceCVDA BATCHLU BIPROG BISYNCH CDRDLPRT CONTNLU HARDCOPY INTACTLU ISCMMCONV LUCMODGRP LUCSESS LUTYPE4 LUTYPE6 MAGTAPE RESSYS SDLC SEQDISK SYSTEM3 SYSTEM7 SYS370 SYS7BSCA TCONSOLE DecValueHexValue 191 160 128 24 189 32 190 209 210 211 193 192 20 208 176 18 161 2 164 166 8 BF A0 80 18 BD 20 BE D1 D2 D3 C1 C0 14 D0 B0 12 A1 2 A4 A6 8

278

CICS TS for z/OS: CICS Users Handbook

CVDA
In alphabetic sequenceCVDA TELETYPE TTCAM TWX3335 T1050 T1053 T2260L T2260R T2265 T2740 T2741BCD T2741COR T2770 T2780 T2980 T3275R T3277L T3277R T3284L T3284R T3286L T3286R T3600BI T3601 T3614 T3650ATT T3650PIPE T3650USER T3653HOST T3735 T3740 T3780 T3790 T3790SCSP T3790UP T7770 VIDEOTERM DecValueHexValue 34 80 33 36 74 65 72 76 40 43 42 130 132 134 146 153 145 155 147 156 148 138 177 178 186 184 187 185 136 137 133 180 182 181 1 64 22 50 21 24 4A 41 48 4C 28 2B 2A 82 84 86 92 99 91 9B 93 9C 94 8A B1 B2 BA B8 BB B9 88 89 85 B4 B6 B5 1 40

In HexValue numerical sequenceDecValue 1 1 2 2 8 8 18 12 20 14 24 18 32 20 33 21 34 22 36 24 40 28 42 2A 43 2B

CVDA

T7770 SYSTEM7 TCONSOLE SEQDISK MAGTAPE CDRDLPRT HARDCOPY TWX3335 TELETYPE T1050 T2740 T2741COR T2741BCD
Chapter 7. CICS-value data areas used by all commands

279

CVDA
In HexValue numerical sequenceDecValue 64 40 65 41 72 48 74 4A 76 4C 80 50 128 80 130 82 132 84 133 85 134 86 136 88 137 89 138 8A 145 91 146 92 147 93 148 94 153 99 155 9A 156 9B 160 A0 161 A1 164 A4 166 A6 176 B0 177 B1 178 B2 180 B4 181 B5 182 B6 184 B8 185 B9 186 BA 187 BB 189 BD 190 BE 191 BF 192 C0 193 C1 208 D0 209 D1 210 D2 211 D3 CVDA

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 CONTNLU INTACTLU BATCHLU LUTYPE6 LUTYPE4 RESSYS ISCMMCONV LUCMODGRP LUCSESS

280

CICS TS for z/OS: CICS Users Handbook

Chapter 8. EXEC interface block (EIB)


This chapter contains General-use Programming Interface information.

EIB field names and descriptions


EIB field COBOL C/370 PL/I ASM

EIBAID EIBATT EIBCALEN EIBCOMPL EIBCONF EIBCPOSN EIBDATE EIBDS EIBEOC EIBERR EIBERRCD EIBFMH EIBFN EIBFREE EIBNODAT EIBRCODE EIBRECV EIBREQID EIBRESP EIBRESP2 EIBRLDBK EIBRSRCE EIBSIG EIBSYNC EIBSYNRB EIBTASKN EIBTIME EIBTRMID EIBTRNID

PIC PIC PIC PIC PIC PIC PIC PIC PIC PIC PIC PIC PIC PIC PIC PIC PIC PIC PIC PIC PIC PIC PIC PIC PIC PIC PIC PIC PIC

X(1) X(1) S9(4) X(1) X(1) S9(4) S9(7) X(8) X(1) X(1) X(4) X(1) X(2) X(1) X(1) X(6) X(1) X(8) S9(8) S9(8) X(1) X(8) X(1) X(1) X(1) S9(7) S9(7) X(4) X(4)

COMP

COMP COMP-3

COMP COMP

COMP-3 COMP-3

char eibaid[1] char eibatt[1] short int eibcalen char eibcompl[1] char eibconf[1] short int eibcposn char eibdate[4] char eibds[8] char eibeoc[1] char eiberr[1] char eiberrcd[4] char eibfmh[1] char eibfn[2] char eibfree[1] char eibnodat[1] char eibrcode[6] char eibrecv[1] char eibreqid[8] long int eibresp long int eibresp2 char eibrldbk[1] char eibrsrce[8] char eibsig[1] char eibsync[1] char eibsynrb[1] char eibtaskn[4] char eibtime[4] char eibtrmid[4] char eibtrnid[4]

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

Copyright IBM Corp. 1989, 2002

281

EIB

EIBFN codes
In the column of the EIBFN codes table headed 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 Users Guide.
EIBFN value X0202 X0204 X0206 X0208 X020A X020C X020E X0210 X0402 X0404 X0406 X0408 X040A X040C X040E X0410 X0412 X0414 X0416 X0418 X041A X041C X041E X0420 X0422 X0424 X0426 X0428 X042A X042C X042E X0430 X0432 X0434 X0436 X0438 X043A X043C X043E X0602 X0604 X0606 X0608 X060A Command ADDRESS HANDLE CONDITION HANDLE AID ASSIGN IGNORE CONDITION PUSH POP ADDRESS SET RECEIVE SEND CONVERSE ISSUE EODS ISSUE COPY WAIT TERMINAL ISSUE LOAD WAIT SIGNAL ISSUE RESET ISSUE DISCONNECT ISSUE ENDOUTPUT ISSUE ERASEAUP ISSUE ENDFILE ISSUE PRINT ISSUE SIGNAL ALLOCATE 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 Type API API API API API API API API API API API API API API API API API API API API API API API API API API API API API API API API API API API API API API API API API API API API

282

CICS TS for z/OS: CICS Users Handbook

EIB
EIBFN value X060C X060E X0610 X0612 X0614 X0802 X0804 X0806 X0A02 X0A04 X0A06 X0C02 X0C04 X0E02 X0E04 X0E06 X0E08 X0E0A X0E0C X0E0E X1002 X1004 X1006 X1008 X1008 X100A X100C X1202 X1204 X1206 X1208 X1402 X1404 X1406 X1408 X1602 X1604 X1802 X1804 X1806 X1808 X180A X180C X180E X1810 X1812 X1C02 X1E02 X1E04 X1E06 X1E08 X1E0A X1E0C X1E0E Command 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 POST START START BREXIT 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 Type API API API API API API API API API API API API API API API API API API API API API API API API API API API API API API API API API API API API SPI API API API API API API API API API API API API API API API API API
Chapter 8. EXEC interface block (EIB)

283

EIB
EIBFN value X1E10 X1E12 X1E14 X2002 X2004 X2006 X2008 X200A X200C X200E X2014 X2016 X2018 X201A X201C X201E X2202 X2204 X2206 X2402 X2404 X2406 X2408 X240A X240C X240E X2410 X2412 X2414 X2416 X2418 X241A X241C X3002 X3004 X3006 X3008 X300A X300C X300E X3010 X3012 X3014 X3016 X3018 X301A X301C X301E X3020 X3022 X3024 X3026 X3028 X302A Command ISSUE NOTE ISSUE WAIT ISSUE SEND BIF DEEDIT DEFINE COUNTER GET COUNTER UPDATE COUNTER DELETE COUNTER REWIND COUNTER QUERY COUNTER DEFINE DCOUNTER GET DCOUNTER UPDATE DCOUNTER DELETE DCOUNTER REWIND DCOUNTER QUERY DCOUNTER ENABLE PROGRAM DISABLE EXTRACT EXIT ALLOCATE ASSIGN EXTRACT PROCESS FREE ISSUE ABEND CONNECT PROCESS ISSUE CONFIRMATION ISSUE ERROR ISSUE SIGNAL RECEIVE SEND WAIT ISSUE PREPARE EXTRACT ATTRIBUTES CREATE PROGRAM CREATE MAPSET CREATE PARTITIONSET CREATE TRANSACTION CREATE PROFILE CREATE TYPETERM CREATE CONNECTION CREATE TERMINAL CREATE SESSIONS CREATE FILE CREATE LSRPOOL CREATE PARTNER CREATE TRANCLASS CREATE TDQUEUE CREATE JOURNALMODEL CREATE DB2CONN CREATE DB2ENTRY CREATE DB2TRAN CREATE PROCESSTYPE CREATE TSMODEL CREATE ENQMODEL Type API API API API API API API API API API API API API API API API SPI SPI SPI API API API API API API 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

284

CICS TS for z/OS: CICS Users Handbook

EIB
EIBFN value X302C X302E X3030 X3402 X3404 X3406 X3408 X340E X3410 X3412 X3414 X3416 X3418 X341A X341C X341E X3420 X3422 X3424 X3426 X3428 X342A X342C X342E X3430 X3432 X3434 X3436 X3438 X343A X343C X3602 X3602 X3604 X3608 X360A X360E X3610 X3612 X3614 X3616 X3618 X361A X3802 X3804 X3806 X3808 X380A X380C X380E X3810 X3814 X3A02 X3C02 Command CREATE REQUESTMODEL CREATE DOCTEMPLATE CREATE TCPIPSERVICE DEFINE ACTIVITY DEFINE PROCESS RUN ACTIVITY RUN ACQPROCESS ACQUIRE PROCESS ACQUIRE ACTIVITYID DELETE CONTAINER GET CONTAINER PUT CONTAINER RESET ACTIVITY CHECK ACTIVITY CANCEL ACTIVITY CANCEL ACQPROCESS SUSPEND ACTIVITY SUSPEND ACQPROCESS RESUME ACTIVITY RESUME ACQPROCESS DELETE ACTIVITY LINK ACQPROCESS LINK ACTIVITY CANCEL ACQACTIVITY RUN ACQACTIVITY LINK ACQACTIVITY SUSPEND ACQACTIVITY RESUME ACQACTIVITY CHECK ACQPROCESS CHECK ACQACTIVITY RESET ACQPROCESS DEFINE INPUT EVENT DEFINE COMPOSITE EVENT DELETE EVENT ADD SUBEVENT REMOVE SUBEVENT TEST EVENT RETRIEVE REATTACH EVENT RETRIEVE SUBEVENT DEFINE TIMER DELETE TIMER CHECK TIMER FORCE TIMER WEB RECEIVE WEB SEND WEB READ WEB STARTBROWSE WEB READNEXT WEB ENDBROWSE HTTPHEADER WEB WRITE WEB EXTRACT WEB RETRIEVE INQ RRMS DOCUMENT CREATE Type SPI SPI SPI API API API API API API API API API API API API API API API API API API API API API API API API API API API API API API API API API API API API API API API API API API API API API API API API API SPI API

Chapter 8. EXEC interface block (EIB)

285

EIB
EIBFN value X3C04 X3C06 X3C08 X3E0E X3E10 X4202 X4210 X4402 X4410 X4602 X4610 X4802 X4804 X4A02 X4A04 X4C02 X4C04 X4C10 X4E02 X4E04 X4E10 X5002 X5004 X5010 X5202 X5204 X5206 X5208 X5210 X5212 X5214 X5216 X5402 X5404 X5412 X5602 X5602 X5604 X5606 X5610 X5802 X5804 X5806 X5810 X5A02 X5A04 X5C02 X5C04 X5C10 X5E02 X5E04 X5E06 X5E08 X5E12 Command DOCUMENT INSERT DOCUMENT RETRIEVE DOCUMENT SET EXTRACT TCPIP EXTRACT CERTIFICATE INQUIRE AUTINSTMODEL DISCARD AUTINSTMODEL 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 DISCARD TDQUEUE INQUIRE TASK SET TASK CHANGE TASK INQUIRE STORAGE INQUIRE TCLASS Type API API API API API SPI SPI SPI SPI SPI SPI API API API API SPI SPI SPI SPI SPI SPI SPI SPI SPI SPI SPI SPI SPI SPI SPI SPI SPI SPI SPI SPI API API API API API SPI SPI SPI SPI SPI SPI SPI SPI SPI SPI SPI API SPI SPI

286

CICS TS for z/OS: CICS Users Handbook

EIB
EIBFN value X5E14 X5E18 X5E1A X5E1C X5E22 X5E32 X6002 X6004 X6010 X6012 X6014 X6202 X6204 X6402 X6602 X6604 X6612 X6614 X6622 X6624 X6802 X6804 X6812 X6814 X6822 X6824 X6826 X6A02 X6C02 X6C12 X6E02 X6E04 X7002 X7004 X7006 X7008 X7012 X7014 X7202 X7402 X7404 X7406 X7408 X7602 X7802 X7804 X7812 X7814 X7822 X7824 X7A02 X7A04 X7C02 X7E02 Command 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 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 INQUIRE EXCI DUMP TRANSACTION Type SPI SPI SPI SPI API API SPI SPI SPI SPI SPI SPI SPI SPI SPI SPI SPI SPI SPI SPI SPI SPI SPI SPI SPI SPI SPI API API API SPI SPI SPI SPI SPI SPI SPI SPI SPI API API API API SPI SPI SPI SPI SPI SPI SPI SPI SPI SPI API
Chapter 8. EXEC interface block (EIB)

287

EIB
EIBFN value X7E04 X8002 X8004 X8012 X8014 X801A X8022 X8030 X820C X820E X8210 X8210 X8212 X8214 X8216 X8218 X821A X821C X821E X8220 X8222 X8224 X8226 X8228 X840E X8422 X8428 X8430 X8442 X8444 X8444 X8448 X844A X844C X8450 X8462 X8464 X8464 X8468 X8470 X8482 X8484 X8484 X8488 X8490 X84A2 X84A4 X8602 X8802 X8A02 X8C02 X9002 X9004 X9022 Command PERFORM DUMP INQUIRE TSQUEUE SET TSQUEUE INQUIRE TSQNAME SET TSQNAME INQUIRE TSPOOL INQUIRE TSMODEL DISCARD TSMODEL REQUEST PASSTICKET AP ALLOCATE POOL ALLOCATE PASSCONVID CONVERSE FORMATTED CONVERSE DATASTREAM EXTRACT CONV EXTRACT FIELD EXTRACT STSN FREE ISSUE RECEIVE FORMATTED RECEIVE DATASTREAM SEND FORMATTED SEND DATASTREAM START SP NOOP INQUIRE PROPERTYSET INSTALL PROPERTYSET DISCARD PROPERTYSET INQUIRE NODE SET NODE SET NODELIST INSTALL NODELIST ADD POOL DELETE POOL DISCARD NODELIST INQUIRE POOL SET POOL SET POOLLIST INSTALL POOL DISCARD POOL INQUIRE TARGET SET TARGETLIST SET TARGET INSTALL TARGETLIST DISCARD TARGETLIST INQUIRE CONNECTION SET CONNECTION ACQUIRE INQUIRE EXITPROGRAM INQUIRE REQID WRITE MESSAGE INQUIRE UOW SET UOW INQUIRE UOWENQ Type SPI SPI SPI SPI SPI SPI SPI SPI 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 FEPI FEPI FEPI FEPI FEPI SPI SPI SPI API SPI SPI SPI

288

CICS TS for z/OS: CICS Users Handbook

EIB
EIBFN value X9042 X9044 X9062 X9082 X9084 X9090 X9202 X9210 X9212 X9402 X9404 X9410 X9422 X9424 X9430 X9442 X9444 X9450 X9602 X9604 X9610 X9612 X9614 X9616 X9618 X9620 X9622 X9624 X9626 X9628 X962A X962C X962E X9630 X9632 X9634 X9636 X9638 X963A X963C X963E X9802 X9A02 X9A10 X9C02 X9C04 X9C10 X9C12 X9C14 X9C22 X9C24 X9E02 X9E10 XB002 Command 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 STARTBROWSE EVENT GETNEXT EVENT ENDBROWSE EVENT STARTBROWSE PROCESS GETNEXT PROCESS ENDBROWSE PROCESS INQUIRE TIMER STARTBROWSE TIMER GETNEXT TIMER ENDBROWSE 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 INQUIRE JVMPOOL Type SPI SPI SPI SPI SPI SPI SPI SPI SPI SPI SPI SPI SPI SPI SPI SPI SPI SPI SPI SPI SPI SPI SPI SPI SPI SPI SPI SPI SPI SPI SPI SPI SPI SPI SPI SPI SPI SPI SPI SPI SPI SPI SPI SPI SPI SPI SPI SPI SPI SPI SPI SPI SPI SPI
Chapter 8. EXEC interface block (EIB)

289

EIB
EIBFN value Command SET JVMPOOL INQUIRE CORBASERVER SET CORBASERVER PERFORM CORBASERVER DISCARD CORBASERVER INQUIRE DJAR PERFORM DJAR DISCARD DJAR INQUIRE BEAN INQUIRE BRFACILITY SET BRFACILITY INQUIRE DISPATCHER SET DISPATCHER Type SPI SPI SPI SPI SPI SPI SPI SPI SPI SPI SPI SPI SPI

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

XB004 XB202 XB204 XB206 XB210 XB222 XB226 XB230 XB242 XB402 XB404 XB602 XB604

EIBRCODE values
See the notes at the end of the list of values for explanations of the numbers following some of the conditions.
EIBFN 02 .. 04 04 04 04 04 04 04 04 04 04 04 04 04 04 04 04 04 04 04 04 04 04 04 04 04 04 06 06 06 06 .. .. .. .. .. .. .. .. .. .. .. .. .. .. .. .. .. .. .. .. .. .. .. .. .. .. .. .. .. .. EIBRCODE Condition E0 .. .. .. .. .. INVREQ 04 10 C1 C2 D0 D2 D3 D4 D5 E0 E1 E3 E4 E5 E6 E7 E8 EA EB EC ED F1 .. .. .. .. 01 02 03 05 .. .. .. .. .. .. .. .. .. .. .. .. .. .. .. .. .. .. .. .. .. .. 20 40 .. .. .. .. .. .. .. .. .. .. .. .. .. .. .. .. .. .. .. .. .. .. .. .. .. .. .. .. .. .. .. .. .. .. .. .. .. .. .. .. .. .. .. .. .. .. .. .. .. .. .. .. .. .. .. .. .. .. .. .. F6 F7 .. .. .. .. .. .. .. .. .. .. .. .. .. .. .. .. .. .. .. .. .. .. .. .. .. .. .. .. .. .. .. .. .. .. .. .. .. .. .. .. .. .. .. .. .. .. .. .. .. .. .. .. .. .. .. .. .. .. .. .. .. .. .. .. EOF EODS EOF ENDINPT SYSIDERR3 SESSIONERR4 SYSBUSY5 SESSBUSY NOTALLOC INVREQ6 LENGERR7 WRBRK RDATT SIGNAL TERMIDERR NOPASSBKRD NOPASSBKWR IGREQCD CBIDERR PARTNERIDERR NETNAMEIDERR TERMERR EOC INBFMH NOSTART NONVAL FILENOTFOUND ILLOGIC1 LOCKED RECORDBUSY

290

CICS TS for z/OS: CICS Users Handbook

EIB
EIBFN 06 .. 06 .. 06 .. 06 .. 06 .. 06 .. 06 .. 06 .. 06 .. 06 .. 06 .. 06 .. 06 .. 06 .. 06 .. 08 08 08 08 08 08 08 08 08 08 08 08 0A 0A 0A 0A 0A 0A 0A 0A 0A .. .. .. .. .. .. .. .. .. .. .. .. .. .. .. .. .. .. .. .. .. EIBRCODE 08 .. .. 0C .. .. 0D .. .. 0F .. .. 80 .. .. 81 .. .. 82 .. .. 83 .. .. 84 .. .. 85 .. .. 86 .. .. D0 .. .. D1 .. .. D6 .. .. E1 .. .. 01 02 04 08 10 C0 D0 D1 D6 D7 E0 E1 01 02 04 08 20 D0 D1 D6 E1 .. .. .. .. .. .. .. .. .. .. .. .. .. .. .. .. .. .. .. .. .. .. .. .. .. .. .. .. .. .. .. .. .. .. .. .. .. .. .. .. .. .. Condition INVREQ NOTOPEN DISABLED ENDFILE IOERR1 NOTFND DUPREC NOSPACE DUPKEY SUPPRESSED LOADING SYSIDERR3 ISCINVREQ NOTAUTH LENGERR QZERO QIDERR IOERR NOTOPEN NOSPACE QBUSY SYSIDERR3 ISCINVREQ NOTAUTH DISABLED INVREQ LENGERR ITEMERR QIDERR IOERR NOSPACE INVREQ SYSIDERR3 ISCINVREQ NOTAUTH LENGERR

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

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

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

0C .. 0C .. 0E 0E 0E 0E 0E 0E .. .. .. .. .. ..

E1 .. .. .. .. .. LENGERR E2 .. .. .. .. .. NOSTG 01 D6 D9 E0 E1 F1 .. .. .. .. .. .. .. .. .. .. .. .. .. .. .. .. .. .. .. .. .. .. .. .. .. .. .. .. .. .. PGMIDERR NOTAUTH RESUNAVAIL INVREQ LENGERR TERMERR

EIBFN 10 .. 10 .. 10 ..

EIBRCODE 01 .. .. .. .. .. 04 .. .. .. .. .. 11 .. .. .. .. ..

Condition ENDDATA IOERR TRANSIDERR


Chapter 8. EXEC interface block (EIB)

291

EIB
EIBFN 10 .. 10 .. 10 .. 10 .. 10 .. 10 .. 10 .. 10 .. 10 .. 10 .. 10 .. 12 .. 12 .. 12 .. 14 14 14 14 14 14 14 .. .. .. .. .. .. .. EIBRCODE 12 .. .. 20 .. .. 81 .. .. D0 .. .. D1 .. .. D6 .. .. D8 .. .. D9 .. .. E1 .. .. E9 .. .. FF .. .. Condition TERMIDERR EXPIRED NOTFND SYSIDERR3 ISCINVREQ NOTAUTH USERIDERR RESUNAVAIL LENGERR ENVDEFERR INVREQ

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

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

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

32 .. .. .. .. .. ENQBUSY E0 .. .. .. .. .. INVREQ E1 .. .. .. .. .. LENGERR 01 02 05 06 07 09 D6 .. .. .. .. .. .. .. .. .. .. .. .. .. .. .. .. .. .. .. .. .. .. .. .. .. .. .. .. .. .. .. .. .. .. .. JIDERR INVREQ NOTOPEN LENGERR IOERR NOJBUFSP NOTAUTH

16 .. 18 18 18 18 18 18 18 18 18 18 18 18 18 18 18 18 18 18 18 18 18 1A 1A 1A 1A 1A 1A .. .. .. .. .. .. .. .. .. .. .. .. .. .. .. .. .. .. .. .. .. .. .. .. .. .. ..

01 .. .. .. .. .. ROLLEDBACK 01 02 04 08 20 40 80 E1 E3 E4 .. .. .. .. .. .. .. .. .. .. .. E0 04 08 0C 10 E1 .. .. .. .. .. .. .. .. .. .. 02 04 08 10 20 40 80 .. .. .. .. .. .. .. .. .. .. .. .. .. .. .. .. .. .. .. .. .. .. .. .. .. .. .. 01 04 08 10 .. .. .. .. .. .. .. .. .. .. .. .. .. .. .. .. .. .. .. .. .. .. .. .. .. .. .. .. .. .. .. .. .. .. .. .. .. .. .. .. .. .. .. .. .. .. .. .. .. .. .. .. .. .. .. .. .. .. .. .. .. .. .. .. .. .. .. .. .. .. .. .. .. .. .. .. .. .. .. .. .. .. .. .. .. .. .. INVREQ RETPAGE MAPFAIL INVMPSZ2 INVERRTERM RTESOME RTEFAIL LENGERR WRBRK RDATT PARTNFAIL INVPARTN INVPARTNSET INVLDC UNEXPIN IGREQCD TSIOERR OVERFLOW EODS EOC IGREQID INVREQ DSSTAT FUNCERR SELNERR UNEXPIN LENGERR

292

CICS TS for z/OS: CICS Users Handbook

EIB
EIBFN 1A .. 1A .. 1A .. 22 .. 4A .. 56 56 56 56 56 56 56 56 56 56 56 56 56 56 56 56 .. .. .. .. .. .. .. .. .. .. .. .. .. .. .. .. EIBRCODE .. 11 .. .. .. .. .. 2B .. .. .. .. .. .. 20 .. .. .. Condition EODS IGREQCD EOC

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

Notes: 1. When ILLOGIC or IOERR occurs during file control operations, further information is provided in field EIBRCODE, as follows: .. xx xx xx xx .. BDAM response .. xx .. .. .. .. VSAM return code .. .. xx .. .. .. VSAM error code .. .. .. xx .. .. VSAM problem determination code .. .. .. .. xx .. VSAM component code VSAM Administration: Macro Instruction Reference manual for VSAM, and the Data Facility Product Customization Guide for BDAM. 2. When INVMPSZ occurs during BMS operations, byte 3 of 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: .. 04 00 .. .. .. request was for invalid function .. 04 04 .. .. .. no session available and NOQUEUE .. 04 08 .. .. .. mode name not found
Chapter 8. EXEC interface block (EIB)

293

EIB
.. 04 0C .. .. .. mode name invalid .. 04 10 .. .. .. task canceled or timed out during allocation .. 04 14 .. .. .. mode group is out of service .. 04 18 .. .. .. close - DRAIN=ALL (Note: APPC only) .. 08 .. .. .. .. SYSID out of service for function shipping requests, the exit program (XISCONA) may have refused to queue the request because the intersystem connection is busy .. 0C xx .. .. .. SYSID definition error .. 0C 00 .. .. .. name not that of TCTSE .. 0C 04 .. .. .. name not that of remote TCTSE .. 0C 08 .. .. .. mode name not found .. 0C 0C .. .. .. profile not found Further information about SYSIDERR can be found in the CICS Intercommunication Guide. 4. When SESSIONERR occurs, further information is provided in bytes 1 and 2 of EIBRCODE, as follows: .. 08 .. .. .. .. session out of service .. 0C xx .. .. .. session definition error .. 0C 00 .. .. .. name not found .. 0C 0C .. .. .. profile not found Further information about SESSIONERR can be found in the 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: .. .. .. 00 .. .. the request was for a session to a connected terminal or system .. .. .. 01 .. .. the request was for a session to a remotely connected terminal or system, and the error occurred in the terminal-owning region (TOR) or an intermediate system .. .. .. 02 .. .. 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: .. .. .. 04 .. .. ALLOCATE command - TCTTE already allocated

294

CICS TS for z/OS: CICS Users Handbook

EIB
.. .. .. 08 .. .. FREE command - TCTTE in wrong state .. .. .. 0C .. .. CONNECT PROCESS command - SYNCLVL 2 has been requested but cannot be supported on the session in use .. .. .. 10 .. .. 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 .. .. .. 20 .. .. an invalid command has been issued for the LU6.2 conversation type in use .. .. .. 28 .. .. GETMAIN failure on ISSUE PASS command 7. When LENGERR occurs during terminal control operations, further information is provided in byte 1 of EIBRCODE, as follows: .. 00 .. .. .. .. input data is overlong and has been truncated .. 04 .. .. .. .. on output commands, an invalid (FROM)LENGTH has been specified, either less than zero or greater than 32767 .. 08 .. .. .. .. on input commands, an invalid (TO)LENGTH has been specified, greater than 32767 .. 0C .. .. .. .. length error has occurred on ISSUE PASS command

RESP values and conditions


RESP value 00 01 02 03 04 05 06 07 08 09 10 11 12 13 14 15 16 17 Condition NORMAL ERROR RDATT WRBRK EOF EODS EOC INBFMH ENDINPT NONVAL NOSTART TERMIDERR FILENOTFOUND NOTFND DUPREC DUPKEY INVREQ IOERR
Chapter 8. EXEC interface block (EIB)

295

EIB
RESP value 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 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 Condition 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 NOJBUFSP DSSTAT SELNERR FUNCERR UNEXPIN NOPASSBKRD NOPASSBKWR SYSIDERR ISCINVREQ ENQBUSY ENVDEFERR IGREQCD SESSIONERR SYSBUSY SESSBUSY NOTALLOC CBIDERR INVEXITREQ INVPARTNSET INVPARTN PARTNFAIL USERIDERR NOTAUTH

296

CICS TS for z/OS: CICS Users Handbook

EIB
RESP value 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 97 98 99 100 101 102 103 104 105 106 107 108 109 110 111 112 113 114 115 116 117 118 119 120 121 Condition VOLIDERR SUPPRESSED RESIDERR NOSPOOL TERMERR ROLLEDBACK END DISABLED ALLOCERR STRELERR OPENERR SPOLBUSY SPOLERR 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 RESUNAVAIL

# # #

Chapter 8. EXEC interface block (EIB)

297

EIB

298

CICS TS for z/OS: CICS Users Handbook

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 Users Guide.
Command ACQUIRE TERMINAL Condition INVREQ RESP2 2 3 4 5 7 8 LENGERR NOTAUTH TERMIDERR ASSIGN INVREQ 6 100 1 1 2 Meaning The terminal is a remote terminal The terminal is LU6.1, APPC, IRC or a non-VTAM device The terminal is not in service; that is, it is not available for use. VTAM is not open CICS is already in the process of acquiring this session. NOQUEUE and QNOTENAB options are invalid for a logged-on device Out-of-range value supplied in the USERDATALEN option The user associated with the task is not authorized to use this command The terminal cannot be found The 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 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 A CICS BTS request is issued from outside the CICS BTS environment Command syntax options are not allowed in a server program invoked by a distributed program link There is an unknown return code in ESMRESP from the external security manager The CICS external security manager interface is not initialized The external security manager is not responding The supplied password is wrong The new password is not acceptable The USERID is revoked The change password request failed during SECLEVEL processing The user is revoked in the connection to the default group

3 4 5

6 200

CHANGE PASSWORD

INVREQ

13

18 29 NOTAUTH 2 4 19 22 31

Copyright IBM Corp. 1989, 2002

299

Command

Condition USERIDERR

RESP2 8

Meaning The USERID is not known to the external security manager

CHANGE TASK

INVREQ

The PRIORITY value is outside the range 0255 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 110, or the LSRPOOL value was not in the range 18 The user associated with the issuing task is not authorized to use this command The user associated with the task is not authorized to access this particular resource in the way required by this command A distributed program link server application specified the function-shipping session (its principal facility) on the CONVID option A distributed program link server application specified the function-shipping session (its principal facility) on the CONVID option The length specified in ATTRLEN is negative The command cannot be executed because an earlier connection or terminal pool definition has not yet been completed The user associated with the issuing task is not authorized to use this command 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 LOGMESSAGE cvda value is not valid

COLLECT STATISTICS

NOTFND

2 IOERR INVREQ 3 4

NOTAUTH

100

101

CONNECT PROCESS

INVREQ

200

CONVERSE

INVREQ

200

CREATE CONNECTION

LENGERR ILLOGIC

1 2

NOTAUTH

100

102

INVREQ

300

CICS TS for z/OS: CICS Users Handbook

Command

Condition

RESP2 200

CREATE CORBASERVER

LENGERR ILLOGIC

1 2

NOTAUTH

100

INVREQ

200

612

613

615

616

CREATE DB2CONN

LENGERR ILLOGIC

1 2

INVREQ

Meaning The command was executed in a program that has been linked to from a remote system that has not specified the SYNCONRETURN option, or has been linked to locally and is defined with EXECUTIONSET=DPLSUBSET The length specified in ATTRLEN is negative Command cannot be executed because an earlier CONNECTION or TERMINAL pool definition not yet 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 during either the discard or resouce definition phase of the 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 An attempt was made to create an existing CorbaServer without first discarding it Installation of the CORBASERVER definition failed because it already exists Installation of the CORBASERVER definition failed because an invalid JNDlprefix, shelf or certificate value has been specified Installation of the CORBASERVER definition failed because the resource resolution transaction CEJR could not attach Installation of the CORBASERVER definition failed because the specified certificate is not known to the external security manager (ESM) 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 LOGMESSAGE cvda value is not valid

Chapter 9. RESP2 values and their meanings

301

Command

Condition

RESP2 200

NOTAUTH

100

102

103

CREATE DB2ENTRY

LENGERR ILLOGIC

1 2

INVREQ

7 200

NOTAUTH

100

101

102

103

CREATE DB2TRAN

LENGERR ILLOGIC

1 2

Meaning The command was executed in a program defined with an EXECUTIONSET value of DPLSUBSET or a program invoked from a remote system by a distributed program link without the SYNCONRETURN option. The user associated with the issuing task is not authorized to use this command The user associated with the issuing task is not 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 LOGMESSAGE cvda value is not valid 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 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

302

CICS TS for z/OS: CICS Users Handbook

Command

Condition INVREQ

RESP2 n

7 200

NOTAUTH

100

101

102

103

CREATE DJAR

ILLOGIC

INVREQ

200

612 613

614

615

Meaning There is a syntax error in the ATTRIBUTES string, or an error occurred during either the discard or resource definition phase of processing The LOGMESSAGE cvda value is not valid 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 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 command cannot be executed because an earlier CONNECTION or TERMINAL pool definition has not yet been completed There is a syntax error in the ATTRIBUTES string, or an error occurred during either the discard or resource definition phase of the processing The command was executed in a program defined with an EXECTIONSET value of DPLSUBSET or a program invoked from a remote system by a distributed program link without the SYNCONRETURN option Installation of the DJAR definition failed because it already exists Installation of the DJAR definition failed because HFSfile, state, CorbaServer, of DJAR invalid Installation of the DJAR definition failed because the specified CORBASERVER does not exist Installation of the DJAR definition failed because the resource resolution transaction CEJR could not attach

Chapter 9. RESP2 values and their meanings

303

Command

Condition

RESP2 617

618

LENGERR NOTAUTH

1 100

CREATE DOCTEMPLATE

LENGERR INVREQ

1 n

7 200

NOTAUTH

100

CREATE ENQMODEL

LENGERR INVREQ

1 n

7 200

NOTAUTH

100

101

CREATE FILE

LENGERR

Meaning Installation of the DJAR definition failed because the specified CORBARSERVER is not in a valid state The installation of a DJAR has failed because its HFSFILE is a duplicate of one that already exists The 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 There is a syntax error in the ATTRIBUTES string, or an error occurred during either the discard or resource definition phase of processing The LOGMESSAGE cvda value is not valid 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 The LOGMESSAGE cvda value is not valid 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

304

CICS TS for z/OS: CICS Users Handbook

Command

Condition ILLOGIC

RESP2 2

NOTAUTH

100

101

INVREQ

7 200

CREATE JOURNALMODEL

LENGERR ILLOGIC

1 2

NOTAUTH

100

INVREQ

7 200

CREATE LSRPOOL

LENGERR ILLOGIC

1 2

NOTAUTH

100

Meaning The command cannot be executed because an earlier connection or terminal pool definition has not yet been completed The user associated with the issuing task is not authorized to use this command The user associated with the issuing task is not authorized to create 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 The LOGMESSAGE cvda value is not valid 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 LOGMESSAGE cvda value is not valid 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

Chapter 9. RESP2 values and their meanings

305

Command

Condition INVREQ

RESP2 n

7 200

CREATE MAPSET

LENGERR ILLOGIC

1 2

NOTAUTH

100

101

INVREQ

7 200

CREATE PARTITIONSET

LENGERR ILLOGIC

1 2

NOTAUTH

100

101

INVREQ

Meaning There is a syntax error in the ATTRIBUTES string, or an error occurred during either the discard or resource definition phase of processing The LOGMESSAGE cvda value is not valid 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 LOGMESSAGE cvda value is not valid 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 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

306

CICS TS for z/OS: CICS Users Handbook

Command

Condition

RESP2 7 200

CREATE PARTNER

LENGERR ILLOGIC

1 2

NOTAUTH

100

INVREQ

7 200

CREATE PROCESSTYPE

LENGERR ILLOGIC

1 2

NOTAUTH

100

101

102

INVREQ

Meaning The LOGMESSAGE cvda value is not valid 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 LOGMESSAGE cvda value is not valid 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 PROCESSTYPE definition with this name The caller does not have surrogate authority to install the resource with the particular userid There is a syntax error in the ATTRIBUTES string, or an error occurred during either the discard or resource definition phase of processing The LOGMESSAGE cvda value is not valid

Chapter 9. RESP2 values and their meanings

307

Command

Condition

RESP2 200

CREATE PROFILE

LENGERR ILLOGIC

1 2

NOTAUTH

100

INVREQ

7 200

CREATE PROGRAM

LENGERR ILLOGIC

1 2

NOTAUTH

100

101

INVREQ

7 200

CREATE REQUESTMODEL

LENGERR

Meaning The command was executed in a program that has been linked to from a remote system that has not specified the SYNCONRETURN option, or has been linked to locally and is defined with EXECUTIONSET=DPLSUBSET The length specified in ATTRLEN is negative The command cannot be executed because an earlier CONNECTION or TERMINAL pool definition has not yet been completed The user associated with the issuing task is not authorized to use this command There is a syntax error in the ATTRIBUTES string, or an error occurred during either the discard or resource definition phase of processing The LOGMESSAGE cvda value is not valid 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 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 LOGMESSAGE cvda value is not valid 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

308

CICS TS for z/OS: CICS Users Handbook

Command

Condition ILLOGIC

RESP2 2

NOTAUTH

100

INVREQ

7 200

611

618

CREATE SESSIONS

LENGERR ILLOGIC

1 2

NOTAUTH

100

102

INVREQ

7 200

Meaning The command cannot be executed because an earlier CONNECTION or TERMINAL pool definition has not yet been completed The user associated with the issuing task is not authorized to use this command There is a syntax error in the ATTRIBUTES string, or an error occurred during either the discard or resource definition phase of processing The LOGMESSAGE cvda value is not valid 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 Installation of the REQUESTMODEL definition r1 failed because a duplicate pattern already exists in r2 Installation of the REQUESTMODEL definition r1 failed because it is not a valid REQUESTMODEL for this level of CICS 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 SESSIONS 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 The LOGMESSAGE cvda value is not valid 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

Chapter 9. RESP2 values and their meanings

309

Command CREATE TCPIPSERVICE

Condition ILLOGIC

RESP2 2

INVREQ

7 200

LENGERR NOTAUTH

1 100

CREATE TDQUEUE

LENGERR ILLOGIC

1 2

NOTAUTH

100

101

102

INVREQ

7 200

CREATE TERMINAL

LENGERR ILLOGIC

1 2

Meaning The command cannot be executed because an earlier CONNECTION or TERMINAL pool definition has not yet completed Syntax error in ATTRIBUTE string or an error occurred during either the discard or resource definition phase of processing The LOGMESSAGE cvda value is not valid 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 There is a syntax error in the ATTRIBUTES string, or an error occurred during either the discard or resource definition phase of processing The LOGMESSAGE cvda value is not valid 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

310

CICS TS for z/OS: CICS Users Handbook

Command

Condition NOTAUTH

RESP2 100

102

INVREQ

7 200

CREATE TRANCLASS

LENGERR ILLOGIC

1 2

NOTAUTH

100

INVREQ

7 200

CREATE TRANSACTION

LENGERR ILLOGIC

1 2

NOTAUTH

100

101

Meaning 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 The LOGMESSAGE cvda value is not valid 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 LOGMESSAGE cvda value is not valid 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 this particular TRANSACTION

Chapter 9. RESP2 values and their meanings

311

Command

Condition INVREQ

RESP2 n

7 200

CREATE TSMODEL

LENGERR NOTAUTH

1 100

101

INVREQ

7 200

CREATE TYPETERM

LENGERR ILLOGIC

1 2

NOTAUTH

100

INVREQ

Meaning There is a syntax error in the ATTRIBUTES string, or an error occurred during either the discard or resource definition phase of processing The LOGMESSAGE cvda value is not valid 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 LOGMESSAGE cvda value is not valid 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 LOGMESSAGE cvda value is not valid

312

CICS TS for z/OS: CICS Users Handbook

Command

Condition

RESP2 200

DEFINE COUNTER

INVREQ

202 301

302

303

304

305

306 308

309

310

403 404

406 407 DELAY INVREQ 4 5 6 1

Meaning The command was executed in a program that has been linked to from a remote system that has not specified the SYNCONRETURN option, or has been linked to locally and is defined with EXECUTIONSET=DPLSUBSET Duplicate counter name The server has an error code that is not understood by the named counter interface The server cannot create a new named counter because there is not enough space in the named counter pool An unexpected error, such as structure failure or loss of connectivity, has occurred on a macro used to access the coupling facility The pool selection parameter specified in the program cannot be resolved to a valid server name using the current options table The interface is unable to establish a connection to the server for the selected named counter pool An abend occurred during server processing of a request The DFHNCOPT options table module, required for resolving a pool name, could not be loaded During processing of the options table, the named counter interface encountered an unknown entry format An options table entry matching the given pool name specified a user exit program, but the user exit program is not link-edited with the options table and cannot be loaded The POOL parameter contains invalid characters or embedded spaces The COUNTER parameter contains invalid characters or embedded spaces The VALUE parameter is invalid The MINIMUM or MAXIMUM parameter is invalid Hours are out of range Minutes are out of range Seconds are out of range The file name referred to in the FILE option cannot be found in the FCT

DELETE

FILENOTFOUND

Chapter 9. RESP2 values and their meanings

313

Command

Condition CHANGED

RESP2 109

INVREQ

20

21 22 25

26

27 31

42

44

47

51

55 DISABLED 50

Meaning A DELETE command (without RIDFLD) is issued for a file that is defined as a coupling facility data table using the contention update model and the record has been changed since the application program read it for update 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 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 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

314

CICS TS for z/OS: CICS Users Handbook

Command

Condition NOTOPEN

RESP2 60

ISCINVREQ

70

NOTFND

80

NOTAUTH LOADING

101 104

LOCKED

106

RECORDBUSY

107

ILLOGIC

110

IOERR SYSIDERR

120 130

131

132

DUPKEY

140

DELETE COUNTER

INVREQ

201

Meaning The requested file is CLOSED and UNENABLED or the requested file is OPEN and in use by other transactions, but a close request against it has been received or a 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) 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. For a coupling facility data table, the connection to the coupling facility data table has failed The DELETE is issued against a coupling facilty data table that no longer exists 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 Named Counter not found

Chapter 9. RESP2 values and their meanings

315

Command

Condition

RESP2 301

303

304

305

306 308

309

310

403

DEQ

LENGERR INVREQ

1 2 100

DISABLE PROGRAM

NOTAUTH

101

DISCARD AUTINSTMODEL

MODELIDERR INVREQ

1 2 3

Meaning The server has reported an error code that is not understood by the named counter interface An unexpected error, such as structure failure or loss of connectivity, has occurred on a macro used to access the coupling facility The pool selection parameter specified in the program cannot be resolved to a valid server name using the current options table The interface is unable to establish a connection to the server for the selected named counter pool An abend occurred during server processing of a request The DFHNCOPT options table module, required for resolving a pool name, could not be loaded During processing of the options table, the named counter interface encountered an unkonn entry format An options table entry matching the given pool name specified a user exit program, but the user exit program is not link-edited with the options table and cannot be loaded The pool selection parameter contains characters that are not allowed, or embedded spaces The value specified for the LENGTH option is outside the range 1255 The MAXLIFETIME option has an incorrect CVDA 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

NOTAUTH

100

DISCARD CONNECTION

SYSIDERR INVREQ

9 24 25 26 27

316

CICS TS for z/OS: CICS Users Handbook

Command

Condition

RESP2 28 29 38 39 200

NOTAUTH DISCARD CORBASERVER NOTAUTH

100 100

NOTFND DISCARD DB2CONN INVREQ NOTFND NOTAUTH

1 2 1 100

DISCARD DB2ENTRY

INVREQ NOTFND NOTAUTH

2 3 1 100

101

DISCARD DB2TRAN

NOTFND NOTAUTH

1 100

101

DISCARD DJAR

NOTAUTH

100

NOTFND DISCARD DOCTEMPLATE NOTAUTH

1 100

NOTFND DISCARD ENQMODEL NOTFND NOTAUTH

1 1 100

DISCARD FILE

INVREQ

2 3 25

Meaning Indirect connections point to this connection MRO connection and IRC active Delete already in flight The CONNECTION definition is curretnly in use DPL subset without SYNCONRETURN The user of this command is not authorized The user associated with the issuing task is not authorized to use this command The named CorbaServer was not found 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 user associated with the issuing task is not authorized to use this command The named deployed JAR file was not found The user associated with the issuing task is not authorized to use this command The specified DOCTEMPLATE is not installed on this system 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

Chapter 9. RESP2 values and their meanings

317

Command

Condition

RESP2 26 43

FILENOTFOUND NOTAUTH

18 100

101

DISCARD JOURNALMODEL

NOTFND NOTAUTH

1 100 3

DISCARD JOURNALNAME

INVREQ

JIDERR NOTAUTH

1 100 101

DISCARD PARTNER

PARTNERIDERR

1 5

INVREQ

2 3

NOTAUTH

100

DISCARD PROCESSTYPE

INVREQ

NOTAUTH

100

PROCESSERR

DISCARD PROFILE

PROFILEIDERR INVREQ

1 2 3 4

NOTAUTH

100

Meaning 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 The user is not authorized for this command The specified journal name (for example, the system log) cannot be discarded The journal cannot be found The user is not authorized for this command The user does not have the required access authority to the specified journal name The partner cannot be found The Partner Resource Manager (PRM) is not active, because it failed to initialize during CICS initialization The partner definition is currently in use The partner cannot be discarded because its name begins with DFH The user associated with the issuing task is not authorized to use this command The process-type named in the PROCESSTYPE option is not disabled The user associated with the issuing task is not authorized to use this command The process-type named in the PROCESSTYPE option is not defined in the process-type table (PTT) 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

318

CICS TS for z/OS: CICS Users Handbook

Command DISCARD PROGRAM

Condition INVREQ

RESP2 1 11 15

PGMIDERR NOTAUTH

7 100

101

DISCARD REQUESTMODEL

NOTFND NOTAUTH

1 100

DISCARD TCPIPSERVICE

INVREQ NOTFND NOTAUTH

9 3 100

Meaning The resource cannot be discarded because its name begins with DFH The resource definition is currently in use The resource cannot be discarded because it is a user-replaceable module The resource definition cannot be found The user associated with the issuing task is not authorized to use this command The user associated with the issuing task is not authorized to access this particular resource in the way required by this command The requested model name was not found The user associated with the issuing task is not authorized to use this command The TCPIPservice is still open The TCPIPSERVICE name was not found The user associated with the issuing task is not authorized to use this command The queue cannot be found The queue name begins with the letter C The queue is not closed Disable pending The queue is not disabled 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

DISCARD TDQUEUE

QIDERR INVREQ

1 11 18 30 31 200

NOTAUTH

100

101

DISCARD TERMINAL

TERMIDERR INVREQ

23 33 38 39 40 41 43 44 45

Chapter 9. RESP2 values and their meanings

319

Command

Condition

RESP2 46 200

NOTAUTH DISCARD TRANCLASS TCIDERR INVREQ

100 1 2 12

NOTAUTH

100

DISCARD TRANSACTION

TRANSIDERR INVREQ

1 4 13 14

Meaning Delete already in flight The command was executed in a program that has been linked to from a remote system that has not specified the SYNCONRETURN option, or has been linked to locally and is defined with EXECUTIONSET=DPLSUBSET The use of this command is not authorized The transaction class cannot be found The TRANCLASS definition is in use The transaction class cannot be discarded because installed transactions belong to it The user associated with the issuing task is not authorized to use this command The transaction cannot be found The transaction cannot be discarded because its name begins with C The transaction is a SIT parameter The transaction is scheduled to run at a future time (in use by an interval control element) The transaction is scheduled to run when required resources are available (in use by an automatic initiate descriptor) The user associated with the issuing task is not authorized to use this command The user associated with the issuing task is not authorized to access this particular resource in the way required by this command The TSMODEL does not exist The TSMODEL definition is currentl in use The TS model cannot be discarded because its name begins with DFH The user associated with the issuing task is not authorized to use this command The user associated with the issuing task is not authorized to discard a TSMODEL with this name The retrieved document specified on the FROM option is not in a valid RETRIEVE format The document specified on the FROMDOC option could not be found or was named incorrectly

15

NOTAUTH

100

101

DISCARD TSMODEL

NOTFND INVREQ

1 2 3

NOTAUTH

100

101

DOCUMENT CREATE

INVREQ

NOTFND

320

CICS TS for z/OS: CICS Users Handbook

Command

Condition

RESP2 3

8 DOCUMENT INSERT INVREQ 0

2 NOTFND 1

2 3 4 5 6 7

DOCUMENT RETRIEVE LENGERR

1 2

NOTFND

1 7

DOCUMENT SET

INVREQ NOTFND SYMBOLERR

8 1 0 offset 1 2 3

DUMP TRANSACTION

SUPPRESSED

NOSPACE NOSTG

4 5

Meaning The template specified on the TEMPLATE option could not be found or was named incorrectly The hose codepage specified on the HOSTCODEPAGE option could not be found or was named incorrectly The value specified for DELIMITER is not valid The bookmark specified in the TO option appears before the bookmark on the AT bookmark The retrieved document specified on the FROM option is not in a valid RETRIEVE format The bookmark name on the BOOKMARK option is invalid The document specified on the DOCUMENT option could not be found The document specified on the FROMDOC option could not be found The template specified on the TEMPLATE option could not be found The document specified on the SYMBOL option could not be found The document specified on the AT option could not be found The document specified on the TO option could not be found The document specified on the HOSTCODEPAGE option could not be found MAXLENGTH is less than or equal to zero The length of the receiving buffer is zero, or is too short to contain the document contents The document has not been created, or the name is incorrectly specified The specified client codepage can not be found The value specified for DELIMITER is not valid The document has not been created or the name is incorrectly specified SYMBOLLIST was not used RESP2 contains the offset of the invalid symbol in the list 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

Chapter 9. RESP2 values and their meanings

321

Command

Condition NOTOPEN OPENERR IOERR

RESP2 6 7 9 10 13

INVREQ

13

Meaning 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 The user associated with the task is not authorized to access this particular resource in the way required by this command. The name referred to in the FILE option cannot be found in the FCT The REQID, if any, does not match that of any successful STARTBR command The remote system indicated a failure that does not correspond to a known condition A resource security check has failed on FILE(filename) A VSAM error which does not fall within one of the other CICS response categories has occurred. There has been an I/O error during the operation The SYSID option specified a name that is neither the local nor the remote system (made known to CICS by defining a connection); or the link to the remote system is closed. The value specified for the LENGTH option is outside the range 1255 The MAXLIFETIME option has an incorrect CVDA TRACENUM is outside the range 0199 There is no valid trace destination The user trace master flag is set OFF and EXCEPTION has not been specified FROMLENGTH is outside the range 04000 specified

ENABLE PROGRAM

NOTAUTH

100

101

ENDBR

FILENOTFOUND INVREQ

1 35

ISCINVREQ

70

NOTAUTH ILLOGIC

101 110

IOERR SYSIDERR

120 130

ENQ

LENGERR INVREQ

1 2 1 2 3

ENTER TRACENUM

INVREQ

LENGERR

322

CICS TS for z/OS: CICS Users Handbook

Command Condition EXTRACT ATTRIBUTES INVREQ (APPC)

RESP2 200

EXTRACT ATTRIBUTES INVREQ (MRO)

200

EXTRACT EXIT

NOTAUTH

100

101

EXTRACT PROCESS

INVREQ

200

EXTRACT TCPIP

INVREQ

2 5 2 4 6 7 1 200

LENGERR

FORMATTIME FREE (APPC)

INVREQ INVREQ

FREEMAIN

INVREQ

GET COUNTER

INVREQ

201 301

303

304

305

Meaning A distributed program link server application explicitly, or implicitly by default, specified the function-shipping session (its principal facility) on the CONVID option A distributed program link server application explicitly, or implicitly by default, specified the function-shipping session (its principal facility) on the CONVID option The user associated with the issuing task is not authorized to issue this command The user associated with the task is not authorized to access this particular resource in the way required by this command. A distributed program link server application specified the function-shipping session (its principal facility) on the CONVID option Invalid socket response The command being issued is in a non-TCPIP application CLIENTADDR is too small SERVERNAME is too small CLIENTNAME is too small SERVERNAME is too small The ABSTIME option is in an incorrect format A distributed program link server application specified the function-shipping session (its principal facility) on the CONVID option The storage specified by the DATA or DATAPOINTER parameter was not storage acquired by a GETMAIN command The storage area specified by the DATA or DATAPOINTER parameter was in CICS-key storage, and the program issuing the FREEMAIN command was in user-key. Named counter not found The server has reported an error code that is not understood by the named counter interface An unexpected error, such as structure failure or loss of connectivity, has occurred on a macro used to access the coupling facility The pool selection parameter specified in the program cannot be resolved to a valid server name using the current options table The interface is unable to establish a connection to the server for the selected named counter pool

Chapter 9. RESP2 values and their meanings

323

Command

Condition

RESP2 306 308

309

LENGERR

001

002 003

SUPPRESSED

101

103

GETMAIN

LENGERR

NOSTG

HANDLE ABEND

PGMIDERR

2 9 HANDLE AID INVREQ 200

INQUIRE AUTINSTMODEL

ILLOGIC

MODELIDERR END NOTAUTH

1 2 100

Meaning An abend occurred during server processing of a request The DFHNCOPT options table module, required for resolving a pool name, could not be loaded During processing of the options table, the named counter interface encountered an unknown entry format The current value that the server has attempted to return in the VALUE data area has overflowed into the high-order (sign) bit The current value is too large for a fullword data area by only 1 bit The current value is too large for a fullword data area by a value greater than 1 The maximum value for the named counter has already been assigen and the counter is in the counter-at-limit condition The current value of the named counter is either not within the range specified by the COMPAREMAX and COMPAREMIN parameters when both are assigned or greater than the COMPAREMAX parameter or less than the COMPAREMIN parameter, when only one is specified 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 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

324

CICS TS for z/OS: CICS Users Handbook

Command Condition INQUIRE AUTOINSTALL NOTAUTH

RESP2 100

INQUIRE CFDTPOOL

END ILLOGIC

2 1

POOLERR

1 2

NOTAUTH

100

INQUIRE CONNECTION END ILLOGIC

2 1

NOTAUTH

100

SYSIDERR INQUIRE CORBASERVER NOTAUTH

1 100

NOTFND INQUIRE DB2CONN NOTFND NOTAUTH NOTFND NOTAUTH INQUIRE DB2TRAN NOTFND NOTAUTH INQUIRE DELETSHIPPED INQUIRE DJAR NOTAUTH

1 1 100 1 100 101 1 100 101 100

INQUIRE DB2ENTRY

NOTAUTH

100

NOTFND INQUIRE DOCTEMPLATE END

1 2

Meaning 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 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 user associated with the issuing task is not authorized to use this command The requested DB2CONN cannot be found The requested DB2CONN cannot be found Command authorization failure The requested DB2ENTRY cannot be found Command authorization failure Resource authorization failure The requested DB2TRAN cannot be found Command authorization failure Resource authorization failure The user associated with the issuing task is not authorized to use this command The user associated with the issuing task is not authorized to use this command The named deployed JAR file was not found There are no more resource definitions of this type

Chapter 9. RESP2 values and their meanings

325

Command

Condition ILLOGIC

RESP2 1

NOTAUTH

100

NOTFND INQUIRE DSNAME DSNNOTFOUND END ILLOGIC

1 1 2 1

IOERR

40

| | | |

48

49

NOTAUTH

100

Meaning A START has been given when a browse is already in progress or a NEXT or an END has been given when a browse of this resource type is not in progress The user associated with the issuing task is not authorized to use this command The DOCTEMPLATE specified cannot be found 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 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 reading the ICF catalog to establish the base data set name The user associated with the issuing task is not authorized to use this command The user associated with the issuing task is not authorized to use this command There are no more resource definitions of this type The ENQMODEL cannot be found A START has been issued when a browse of this resoutrce type is already in progress, or a NEXT ot END issued when a browse of this resource type is not in progress The user associated with the issuing task is not authorized to use this command The user associated with the issuing task is not authorized to access this particular resource in the way required by this command There are no more resource definitions of this type A START has been issued when a browse of this resoutrce type is already in progress, or a NEXT ot END issued when a browse of this resource type is not in progress

INQUIRE DUMPDS

NOTAUTH

100

INQUIRE ENQMODEL

END NOTFND ILLOGIC

2 1 1

NOTAUTH

100

101

INQUIRE EXCI

END ILLOGIC

2 1

326

CICS TS for z/OS: CICS Users Handbook

Command

Condition NOTAUTH

RESP2 100

101

INQUIRE EXITPROGRAM

END INVREQ ILLOGIC

2 3 1

NOTAUTH

100

101

Meaning The user associated with the issuing task is not authorized to use this command The user associated with the issuing task is not authorized to access this particular resource in the way required by this command There are no more resource definitions of this type The exit point identified by EXIT does not exist 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 v The exit identified by EXITPROGRAM and ENTRYNAME is not enabled, or v The EXIT parameter is missing for an inquiry on a global user exit, or v The EXIT parameter is present on a task-related user exit There are no more resource definitions as this type The file cannot be found A START has been given when a browse is already in progress or a NEXT or an END has been given when a browse of this resource type is not in progress The user associated with the issuing task is not authorized to use this command The user associated with the issuing task is not authorized to access this particular resource in the way required by this command The user associated with the issuing task is not authorized to use this command All authorized resource definitions have been retrieved. All data areas specified on this command are left unchanged A START has been given when a browse is already in progress or a NEXT or an END has been given without a preceding START The browse token is not valid

PGMIDERR

INQUIRE FILE

END FILENOTFOUND ILLOGIC

2 1 1

NOTAUTH

100

101

INQUIRE IRC

NOTAUTH

100

INQUIRE JOURNALMODEL

END

ILLOGIC

Chapter 9. RESP2 values and their meanings

327

Command

Condition NOTFND NOTAUTH

RESP2 1 100 2

INQUIRE JOURNALNAME

END

ILLOGIC

JIDERR NOTAUTH

1 100 101

INQUIRE JVMPOOL

NOTAUTH

100

INQUIRE MODENAME

END ILLOGIC

2 1

SYSIDERR

1 2 3

NOTAUTH

100

INQUIRE MONITOR

NOTAUTH

100

INQUIRE PARTNER

END ILLOGIC

2 1

PARTNERIDERR

1 2

NOTAUTH

100

Meaning The specified journal model was not found The user is not authorized for this command All authorized resource definitions have been retrieved. All data areas specified on this command are left unchanged A START has been given when a browse is already in progress or a NEXT or an END has been given without a preceding START The specified journal name was not found 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) The user associated with the issuing task is not authorized to use this command 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 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

328

CICS TS for z/OS: CICS Users Handbook

Command INQUIRE PROCESSTYPE

Condition NOTAUTH

RESP2 100

101

PROCESSERR

INQUIRE PROFILE

END ILLOGIC

2 1

PROFILEIDERR NOTAUTH

1 100

INQUIRE PROGRAM

END ILLOGIC

2 1

PGMIDERR NOTAUTH

1 100

101

INQUIRE REQID

NOTFND ILLOGIC

1 1

END INVREQ

2 3

NOTAUTH

100

INQUIRE REQUESTMODEL

NOTFND

Meaning The user associated with the issuing task is not authorized to use this command The user associated with the issuing task is not authorized to access this resource in the way requested The process-type specified on the PROCESSTYPE option could not be found There are no more resource definitions of this type A START has been given when a browse is already in progress, or a NEXT or an END has been given when a browse of this resource type is not in progress The 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 The user associated with the issuing task is not authorized to use this command The user associated with the issuing task is not authorized to access this particular resource in the way required by this command The REQID cannot be found You have issued a START command when a browse is already in progress, or a NEXT or an END issued when a browse of this resource type is not in progress There are no more resource definitions of this type An I/O error occurred while an attempt was made to read data from temporary storage for the SET, QUEUE, RTERMID or RTRANSID option Data required for the SET, QUEUE, RTERMID or RTRANSID option cannot be returned because it has been deleted from temporary storage The user associated with the issuing task is not authorized to use this command The specified erquest model was not found

Chapter 9. RESP2 values and their meanings

329

Command

Condition ILLOGIC

RESP2 1

END NOTAUTH

2 100

INQUIRE STATISTICS

NOTAUTH

100

INQUIRE STORAGE

NOTAUTH

100

TASKIDERR

1 2 100 2

INQUIRE STREAMNAME

NOTAUTH END

NOTFND ILLOGIC

1 1

INQUIRE SYSDUMPCODE

END NOTAUTH

2 2 100

ILLOGIC

NOTFND INQUIRE SYSTEM NOTAUTH

1 100

INQUIRE TASK

TASKIDERR

1 2

NOTAUTH

100

INVREQ

Meaning You have issued a START command when a browse is already in progress, or a NEXT or an END issued when a browse of this resource type is not in progress All authorized resource definitions have been retrieved The user associated with the issuing task is not authorized to use this command The user associated with the issuing task is not authorized to use this command The user associated with the issuing task is not authorized to use this command The task number does not exist The task number is a system task, not a user task The user is not authorized for this command All authorized resource definitions have been retrieved. All data areas specified on this command are left unchanged The requested log stream name was not found A START has been given when a browse is already in progress, or a NEXT or an END has been given without a preceding START The browse token is not valid There are no more resource definitions of this type The user associated with the issuing task is not authorized to use this command A START command has been issued when a browse is already in progress or a NEXT or an END command issued when a browse of this resource type is not in progress The named dump code cannot be found The user associated with the issuing task is not authorized to use this command The named task cannot be found The task is executing a type of transaction which is not subject to this command operator The user associated with the issuing task is not authorized to use this command SUSPENDVALUE is specified but significant characters are lost

330

CICS TS for z/OS: CICS Users Handbook

Command

Condition

RESP2 3

10 INQUIRE TASK LIST NOTAUTH 100

INQUIRE TCLASS

TCIDERR NOTAUTH

1 100

INQUIRE TCPIP

INVREQ NOTAUTH

4 100

INQUIRE TCPIPSERVICE

NOTFND ILLOGIC

3 1

END INVREQ NOTAUTH

2 4 5 100

INQUIRE TDQUEUE

ENDCOND ILLOGIC NOTAUTH

2 1 100

101

INQUIRE TERMINAL

QIDERR NORMAL END ILLOGIC

1 0 2 1

NOTAUTH

100

TERMIDERR

Meaning 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 The user associated with the issuing task is not authorized to use this command The named task class cannot be found The user associated with the issuing task is not authorized to use this command TCPIP=NO has been specified in the system initialization table (SIT) The user associated with the issuing task is not authorized to use this command Named TCPIPSERVICE was not found A START command has been issued when a browse is already in progress or a NEXT or an END command issued when a browse of this resource type is not in progress There are no more resource definitions of this type TCPIP not available (TCPIP=NO) TCPIP is closed The user associated with the issuing task is not authorized to use this command There are no more resource definitions of this type Browse sequence error The user associated with the issuing task is not authorized to use this command The user associated with the issuing task is not authorized to access this particular resource in the way required by this command The named queue cannot be found No errors There are no more resource definitions of this type A START has been given when a browse is already in progress or a NEXT or an END has been given when a browse of this resource type is not in progress The user associated with the issuing task is not authorized to use this command The named terminal cannot be found

Chapter 9. RESP2 values and their meanings

331

Command INQUIRE TRACEDEST

Condition NOTAUTH

RESP2 100

INQUIRE TRACEFLAG

NOTAUTH

100

INQUIRE TRACETYPE

NOTFND

NOTAUTH

100

INQUIRE TRANCLASS

INVREQ NOTAUTH

12 100

101

TCIDERR INQUIRE TRANDUMPCODE END ILLOGIC

1 2 1

NOTAUTH

100

INQUIRE TRANSACTION

NOTFND END ILLOGIC

1 2 1

TRANSIDERR INVREQ

1 3

NORMAL NOTAUTH

10 100

101

Meaning The user associated with the issuing task is not authorized to use this command The user associated with the issuing task is not authorized to use this command CICS was initialized without support for at least one of the components listed in the command; trace levels were returned for all other components The user associated with the issuing task is not authorized to use this command The TRANCLASS definition is in use The user associated with the issuing task is not authorized to use this command The user associated with the issuing task is not authorized to access the particular resource in the way required by this command The transaction class cannot be found There are no more resource definitions of this type A START has been given when a browse is already in progress or a NEXT or an END has been given when a browse of this resource type is not in progress The user associated with the issuing task is not authorized to use this command The dump code cannot be found There are no more resource definitions of this type A START has been given when a browse is already in progress or a NEXT or an END has been given when a browse if this resource type is not in progress 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

332

CICS TS for z/OS: CICS Users Handbook

Command INQUIRE TSMODEL

Condition END ILLOGIC

RESP2 2 1

NOTFND NOTAUTH

1 100

INQUIRE TSPOOL

END ILLOGIC

2 1

NOTFND NOTAUTH

1 100

101

INQUIRE TSQUEUE/TSQNAME

END INVREQ

2 1

ILLOGIC

NOTAUTH

100

101

POOLERR QIDERR SYSIDERR

3 1 3

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

Chapter 9. RESP2 values and their meanings

333

Command

Condition

RESP2 4 5

INQUIRE UOW

END

ILLOGIC

UOWNOTFOUND NOTAUTH INQUIRE UOWDSNFAIL END ILLOGIC

1 100 2 1

NOTAUTH INQUIRE UOWENQ END ILLOGIC

100 2 1

Meaning An error has occurred in the shared TS server An I/O error has occurred on the coupling facility All authorized resource definitions have been retrieved. All data areas specified on this command are left unchanged A browse of this resource type is already in progress, or an INQUIRE UOW START command has not been issued A named UOW cannot be found A use of this command is not authorized There are no more UOW/data set pairs A START has been given when a browse is already in progress, or a NEXT has been given without a preceding START A use of this command is not authorized All enqueues have been retrieved v For INQUIRE UOQENQ START - a browse of this resource is already in progress v 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 v For INQUIRE UOQLINK START - a browse of this resource is already in progress v 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 The program has issued an INQUIRE VOLUME browse command. This command is withdrawn VTAM is not present in the system The user associated with the issuing task is not authorized to use this command

UOWNOTFOUND NOTAUTH INQUIRE UOWLINK END ILLOGIC

1 100 2 1

UOWLNOTFOUND UOWNOTFOUND NOTAUTH INQUIRE VOLUME VOLIDERR

1 1 100 1

INQUIRE VTAM

INVREQ NOTAUTH

1 100

334

CICS TS for z/OS: CICS Users Handbook

Command INQUIRE WEB

Condition NOTAUTH

RESP2 100

ISSUE ABEND

INVREQ

200

ISSUE ABORT

INVREQ

200

ISSUE ADD

INVREQ

200

ISSUE CONFIRMATION

INVREQ

200

ISSUE END

INVREQ

200

ISSUE ENDFILE

INVREQ

200

ISSUE ENDOUTPUT

INVREQ

200

ISSUE EODS

INVREQ

200

ISSUE ERASE

INVREQ

200

ISSUE ERASEAUP

INVREQ

200

ISSUE ERROR

INVREQ

200

ISSUE NOTE

INVREQ

200

ISSUE PREPARE

INVREQ

200

Meaning The user associated with the issuing task is not authorized to use this command A distributed program link server application specified the function-shipping session (its principal facility) on the CONVID option A distributed program link server application specified the function-shipping session (its principal facility) on the CONVID option A distributed program link server application specified the function-shipping session (its principal facility) on the CONVID option A distributed program link server application specified the function-shipping session (its principal facility) on the CONVID option A distributed program link server application specified the function-shipping session (its principal facility) on the CONVID option A distributed program link server application attempted to send on its function-shipping session, its principal facility A distributed program link server application attempted to send on its function shipping session, its principal facility A distributed program link server application attempted to send on its function shipping session, its principal facility A distributed program link server application specified the function-shipping session (its principal facility) on the CONVID option A distributed program link server application specified the function-shipping session (its principal facility) on the CONVID option A distributed program link server application specified the function-shipping session on the CONVID option 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

Chapter 9. RESP2 values and their meanings

335

Command ISSUE PRINT

Condition INVREQ

RESP2 200

ISSUE QUERY

INVREQ

200

ISSUE RECEIVE

INVREQ

200

ISSUE REPLACE

INVREQ

200

ISSUE SEND

INVREQ

200

ISSUE SIGNAL (APPC)

INVREQ

200

ISSUE WAIT

INVREQ

200

LINK

INVREQ

14

15

16 17 19

Meaning A distributed program link server application specified the function-shipping session (its principal facility) on the CONVID option A distributed program link server application specified the function-shipping session (its principal facility) on the CONVID option A distributed program link server application specified the function-shipping session (its principal facility) on the CONVID option A distributed program link server application specified the function-shipping session (its principal facility) on the CONVID option A distributed program link server application specified the function-shipping session (its principal facility) on the CONVID option A distributed program link server application specified the function-shipping session (its principal facility) on the CONVID option A distributed program link server application specified the function-shipping session (its principal facility) on the CONVID option 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 in the remote region specified on the SYSID option. (That is, a logical unit-of-work (LUW) is in progress or MRO=YES has been specified in the client region). In this case, the client program is in an incorrect state to support the SYNCONRETURN option 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 The TRANSID supplied by the dynamic routing program 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

336

CICS TS for z/OS: CICS Users Handbook

Command

Condition

RESP2 30

41 43

44 45

46

47

48

LENGERR

11 12

13

26 27 NOTAUTH PGMIDERR 101 1

Meaning 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 A LINK has been attempted to a Java program on the link stack A LINK has been attempted to a hot-pooled Java program object while there is already a hot-pooled program on the link stack A LINK has been attempted to a Java program, but the JVMPool is disabled A LINK has been attempted to a Java program, but the JVM profile cannot be found A LINK has been attempted to a Java program, but the JVM profile is not valid A LINK has been attempted to a Java program, but the system properties file cannot be found A LINK has been attempted to a Java program, but the user class cannot be found 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) 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

Chapter 9. RESP2 values and their meanings

337

Command

Condition

RESP2 3

Meaning A program cannot be loaded because v This was the first load of the program and the program load failed, usually because the load module could not be found v This was a subsequent load of the program, but the first load failed In order to reset the load status the load module must be in the DFHRPL concatenation, and a SET PROGRAM NEWCOPY will be required The program autoinstall control program failed either because the program autoinstall control program is incorrect, incorrectly defined, or as a result of an abend in the program autoinstall control program. Program autoinstall is disabled and message DFHPG0202 or DFHPG0203 written to the CSPL The model returned by the program autoinstall control program is not defined in the PPT table, or is not enabled The program autoinstall control program returned invalid data Define for the program failed due to autoinstall returning an invalid program name or definition The dynamic routing program rejected the link request An XICERES globaluser exit program has indicated that a required resource is unavailable on the target region. 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 the remote system specified by SYSID is not in service The remote system specified by SYSID is in service, but there are not sessions available The request to allocate a session to the remote system has been rejected

21

22

23 24

25

# # #

RESUNAVAIL

ROLLEDBACK

29

SYSIDERR

18

20

28 29

31

338

CICS TS for z/OS: CICS Users Handbook

Command

Condition

RESP2 32

TERMERR

17

LOAD

INVREQ

30

LENGERR

19

NOTAUTH PGMIDERR

101 1

2 3

Meaning The queue of allocate requests for sessions to the remote system has been purged An unrecoverable error occurred during the conversation with the mirror (for example, the session failed or the server region failed) The program manager domain has not yet been initialized. This is probably due to a load request having been made in a first stage PLT 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 v This was the first load of the program and the program load failed, usually because the load module could not be found v 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 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

9 21

22

23 24

Chapter 9. RESP2 values and their meanings

339

Command

Condition

RESP2 42

MONITOR

INVREQ

1 2 3 4 5 6

PERFORM CORBASERVER

INVREQ

2 10 ? ?

NOTAUTH

100

NOTFND PERFORM DELETSHIPPED PERFORM DJAR NOTAUTH

1 100

INVREQ

2 10 ?

NOTAUTH

100

NOTFND PERFORM DUMP SUPPRESSED

1 1

NOSPACE

Meaning An attempt has been made to LOAD a JVM program and Java byte codess programs are not managed by CICS Loader POINT value is outside the range 1255 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 specified CVDA value is invalid (not either PUBLISH or RETRACT) The JNDI namespace could not be accessed The state of the CorbaServer is not INSERVICE At least one deployed JAR file belonging to the CorbaServer is in a state other than INSERVICE The user associated with the issuing task is not authorized to use this command The named CorbaServer cannot be found The user associated with the issuing task is not authorized to use this command The specified CVDA value is invalid (not PUBLISH or RETRACT) The JNDI namespace could not be accessed The state of the deployed JAR file is not INSERVICE The user associated with the issuing task is not authorized to use this command The named deployed JAR file cannot be found 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

340

CICS TS for z/OS: CICS Users Handbook

Command

Condition NOSTG INVREQ

RESP2 5 6 7 13

IOERR

9 10 12

13 SYSBUSY NOTAUTH 11 100

PERFORM ENDAFFINITY

INVREQ

25 26

Meaning 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 The connection is still in service There may be recovery information outstanding for the connection. RECOVSTATUS has a value other than NORECOVDATA See message DFHZC0178. VTAM could not end the affinity for a reason other than 35 (NOTFOUND) or 36 (SESSIONS ACTIVE) Enter NETID. NETID was not specified, and cannot be obtained from the installed connection. This may be because the connection does not exist, or because it does not contain a NETID value VTAM could not find an affinity for the values input VTAM could not end the affinity because the connection had some sessions active See message DFHZC0176. A VTAM error prevented the CHANGE AFFINITY macro being carried out There is no clock in the system The user associated with the issuing task is not authorized to use this command No ESM is installed, or the ESM is inactive The ESM is temporarily inactive and cannot perform the action requested Error returned from ESM. The return code is in ESMRESP, if the option was used

32

34

35 36

37

PERFORM RESETTIME

INVREQ NOTAUTH

1 100

PERFORM SECURITY REBUILD

INVREQ

1 5

IOERR

Chapter 9. RESP2 values and their meanings

341

Command

Condition NOTAUTH

RESP2 100

NORMAL

0 4

SYSBUSY PERFORM SHUTDOWN INVREQ

3 1

2 3 4 5 6 7 TRANSIDERR NOTAUTH 8 100

PERFORM STATISTICS RECORD

IOERR

NOTAUTH

100

Meaning The user associated with the issuing task is not authorized to use this command Profiles have been refreshed No action is required, because RACF is at Version 2.1 (or later), and so profiles are refreshed automatically A security rebuild is currently in progress A normal shutdown has been requested when shutdown was already in progress The XLT cannot be found The PLT cannot be found XRF is not in effect The transaction specified on SDTRAN is not enabled for shutdown The transaction specified on SDTRAN is not defined as remote The transaction specified on SDTRAN is not enabled The shutdown transaction specified on SDTRAN was not found The user associated with the issuing task is not authorized to use this command 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

342

CICS TS for z/OS: CICS Users Handbook

Command

Condition NOTFND

RESP2 n

Meaning 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 31 DB2 32 TCPIPSERVICE 33 TCPIP 34 REQUESTMODEL 35 CORBASERVER 36 JVMPOOL Hours are out of range Minutes are out of range Seconds are out of range The command was called in a distributed program link server program Named counter not found The server has reported an error code that is not understoon by the named counter interface An unexpected error, such as structure failure or loss of connectivity, has occurred on a macro used to access the coupling facility The pool selection parameter specified in the program cannot be resolved to a valid server name using the current options table The interface is unable to establish a conneciton to the server for the selected named counter pool

POST

INVREQ

PURGE MESSAGE

INVREQ

4 5 6 200

QUERY COUNTER

INVREQ

201 301

303

304

305

Chapter 9. RESP2 values and their meanings

343

Command

Condition

RESP2 306 308

309

310

403 404

LENGERR

001

002 003 QUERY SECURITY NOTFND 1 2 3 5 8

Meaning An abend occurred during server processing of a request The DFHNCOPT options table, required for resolving a pool name, could not be loaded During processing of the options table, the named counter interface encountered an unknown entry format An options table entry matching a given pool name specified a user exit program, but the user exit program is not link-edited with the options table and cannot be loaded The POOL parameter contains invalid characters or embedded spaces The COUNTER parameter contains invalid characters or embedded spaces The current value that the server has attempted to return in one of the data areas has overflowed into the high-order (sign) bit A value is too large for a fullword data area by only 1 bit A value is too large for a fullword data area by a vlaue greater than 1 The RESID is not valid The RESTYPE is not valid The RESID value for RESTYPE (SPCOMMAND) is not valid The RESCLASS is not defined to the external security manager (ESM) The resource is not protected Possible causes include v RESCLASS not active v No profile found v 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 1246 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 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

QIDERR LENGERR INVREQ

1 6 7 9 10

READ

FILENOTFOUND LENGERR

1 10

344

CICS TS for z/OS: CICS Users Handbook

Command

Condition

RESP2 11

13 INVREQ 20

25

26

28

40 42

44

51

52 53 55

Meaning The length of a record read with the INTO option specified exceeds the value specified in the LENGTH option; the record is truncated, and the data area supplied in the LENGTH option is set to the actual length of the record An incorrect length is specified for a file with fixed-length records 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 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

Chapter 9. RESP2 values and their meanings

345

Command

Condition

RESP2 56

DISABLED

50

NOTOPEN

60

ISCINVREQ

70

NOTFND

80

NOTAUTH LOADING

101 104

LOCKED

106

RECORDBUSY

107

ILLOGIC

110

IOERR SYSIDERR

120 130

Meaning An attempt to update a recoverable coupling facility data table has failed because the current unit of work has already updated 1024 recoverable coupling facility data tables 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) 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.

346

CICS TS for z/OS: CICS Users Handbook

Command

Condition

RESP2 131

132 DUPKEY 140

READNEXT

FILENOTFOUND LENGERR

1 10

11

13 LOADING 104

INVREQ

20 25

26

34

37

42

Meaning For a coupling facility data table, the connection to the coupling facility data table has failed The READ is issued for a coupling facility data table that no longer exists 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 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 read request specifies a record key for a record in a coupling facility data table that is still being loaded, and the key is out of range of the records already loaded 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 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

Chapter 9. RESP2 values and their meanings

347

Command

Condition

RESP2 52

53

54

55

ISCINVREQ

70

NOTFND

80

ENDFILE NOTAUTH LOCKED

90 101 106

RECORDBUSY

107

ILLOGIC

110

IOERR SYSIDERR

120 130

131

132 DUPKEY 140

READPREV

FILENOTFOUND LENGERR

1 10

Meaning 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) 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. For a coupling facility data table, the connection to the coupling facility data table has failed The READ is issued for a coupling facility data table that no longer exists 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

348

CICS TS for z/OS: CICS Users Handbook

Command

Condition

RESP2 11

13 INVREQ 20 24

26

37

39 41

52

53

54

55

ISCINVREQ

70

NOTFND

80

ENDFILE NOTAUTH LOCKED

90 101 106

Meaning The length of a record read with the INTO option specified exceeds the value specified in the LENGTH option; the record is truncated, and the data area supplied in the LENGTH option is set to the actual length of the record An incorrect length is specified for a file with fixed-length records The FILE definition does not allow updates A READPREV command is issued for a file for which the previous STARTBR or RESETBR command has the GENERIC option The KEYLENGTH option is specified and the specified length does not equal the length defined for the data set this file refers to The type of record identification used to access a data set during the browse is changed A READPREV is issued for a BDAM file The REQID, if any, does not match that of any successful STARTBR command CONSISTENT is not allowed because the file is not a VSAM file that is accessed in RLS-mode REPEATABLE is not allowed because the file is not a VSAM file that is accessed in RLS-mode 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

Chapter 9. RESP2 values and their meanings

349

Command

Condition RECORDBUSY

RESP2 107

ILLOGIC

110

IOERR SYSIDERR

120 130

131

132 DUPKEY 140

READQ TS

IOERR NOTAUTH SYSIDERR

5 101 4

RECEIVE

INVREQ

200

RELEASE

PGMIDERR

1 2 9 42

INVREQ

5 6

Meaning 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 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. For a coupling facility data table, the connection to the coupling facility data table has failed The READ is issued for a coupling facility data table that no longer exists 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 There is an irrecoverable input/output error for a shared queue A resource security check has failed on QUEUE(name) The CICS region in which the temporary storage command is executed fails to connect to the TS server managing the TS pool that supports the referenced temporary storage queue, or the temporary storage server has not been started, or the server has failed A distributed program link server application specified the function-shipping session (its principal facility) on the CONVID option A program, table, or map has no entry in the PPT A program, table, or map is disabled The installed program definition is for a remote program An attempt has been made to RELEASE a JVM program (Java byte codes programs are not managed by CICS Loader) 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

350

CICS TS for z/OS: CICS Users Handbook

Command

Condition

RESP2 7

17

30 RESETBR FILENOTFOUND INVREQ 1 25

26

36

42

44

51

ISCINVREQ

70

NOTFND

80

NOTAUTH ILLOGIC

101 110

IOERR SYSIDERR

120 130

Meaning A RELEASE command has been issued for a program that is loaded, without the HOLD option, by another task, or the program has been enabled as a global user exit A program has been defined with RELOAD=YES. It must be released by a FREEMAIN rather than a RELEASE command 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 The command does not conform to the format of the RESETBR for a user-maintained or coupling facility data table 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 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.

Chapter 9. RESP2 values and their meanings

351

Command

Condition

RESP2 131

132 RESYNC ENTRYNAME NOTAUTH 100

RETURN

INVREQ

30

200

LENGERR

11 26

27 REWIND COUNTER INVREQ 201 301

303

304

305

306

Meaning For a coupling facility data table, the connection to the coupling facility data table has failed The READ is issued for a coupling facility data table that no longer exists The user associated with the issuing task is not authorized to use this command A RETURN command with the TRANSID option has been issued by a program that is not associated with a terminal A RETURN command with the COMMAREA or IMMEDIATE option has been issued in a program that is not at the highest logical level A RETURN command with the TRANSID option has been issued in a program that is associated with an APPC logical unit 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 Named counter not found The server has reported an error code that is not understood by the named counter interface An unexpected error, such as structure failure or loss of connectivity, has occurred on a macro used to access the coupling facility The pool selection parameter specified in the program cannot be resolved to a valid server name using the current options table The interface is unable to establish a connection to the server for the selected named counter pool An abend occurred during server processing of a request

352

CICS TS for z/OS: CICS Users Handbook

Command

Condition

RESP2 308

309

310

403 404

SUPPRESSED REWRITE FILENOTFOUND LENGERR

406 102 1 10

12 14 INVREQ 30

46

47

55

56

ISCINVREQ

70

NOSPACE

100

102

Meaning The DFHNCOPT options table module, required for resolving a pool name, could not be loaded During processing of the options table, the named counter interface encountered an unknown entry format An options table entry matching the given pool name specified a user exit program, but the user exit program is not link-edited with the options table and cannot be loaded The POOL parameter contains invalid characters or embedded spaces The COUNTER parameter contains invalid characters or embedded spaces The INCREMENT value is invalid The named counter has not yet reached its limit 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 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 An attempt to update a recoverable coupling facility data table has failed because the current unit of work has already updated 1024 recoverable coulping facility data tables 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 The maximum number of records specified for a recoverable coupling facility data table has been exceeded

Chapter 9. RESP2 values and their meanings

353

Command

Condition

RESP2 103

108

NOTAUTH NOTFND

101 80

LOCKED

106

RECORDBUSY

107

ILLOGIC

110

IOERR SYSIDERR

120 130

131

132 DUPREC 150

CHANGED

109

ROUTE

INVREQ

4 5 6

Meaning For user-maintained data tables, CICS is unable to get sufficient storage in the CICS address space to store the updated data table entry For coupling facility data tables, there is insufficient space in the coupling facility data table pool to store the updated record A resource security check has failed on FILE(filename) For user-maintained data tables, an attempt to REWRITE a record has failed because the REWRITE is associated with a READ UPDATE request for a record that this transaction deleted after it was read for update 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. For a coupling facility data table, the connection to the coupling facility data table has failed The READ is issued for a coupling facility data table that no longer exists 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 A REWRITE command is issued for a file that is defined as a coupling facility data table using the contention update model and the record has been changed since the application program read it for update Hours are out of range Minutes are out of range Seconds are out of range

354

CICS TS for z/OS: CICS Users Handbook

Command

Condition

RESP2 200 200

SEND

INVREQ

SEND CONTROL

INVREQ

200

SEND MAP

INVREQ

200

SEND PAGE

INVREQ

200

SEND PARTNSET

INVREQ

200

SEND TEXT

INVREQ

200

SEND TEXT MAPPED

INVREQ

200

SEND TEXT NOEDIT

INVREQ

200

SET AUTOINSTALL

INVREQ

1 2 4

20 NOTAUTH 100

SET CONNECTION

PGMIDERR INVREQ

3 1 2

3 4

Meaning BMS commands are not supported for distributed program link A distributed program link server application has attempted to send on its function-shipping session (its principal facility) or, for SEND (APPC), a distributed program link server application has specified the function-shipping session (its principal facility) on the CONVID option A distributed program link server application has attempted to send on its function-shipping session (its principal facility) Command is not allowed for a distributed program link server program Command is not allowed for a distributed program link server program Command is not allowed for a distributed program link server program Command is not allowed for a distributed program link server program A distributed program link server application has specified the function-shipping session (its principal facility) on the CONVID option Command is not allowed for a distributed program link server program VTAM is not in use in this system The MAXREQS value is not in the range 0999 One of the modules invoked by DFHZATDX (DFHZATA and DFHZATD) cannot be found The console has an invalid CVDA value The user associated with the issuing task is not authorized to use this command The program name cannot be found ACQSTATUS|CONNSTATUS was specified for a non-APPC connection 1. ACQUIRED specified with OUTSERVICE 2. ACQUIRED specified for OUTSERVICE connection 3. OUTSERVICE specified for ACQUIRED connection ACQSTATUS|CONNSTATUS has an invalid CVDA value SERVSTATUS has an invalid CVDA value

Chapter 9. RESP2 values and their meanings

355

Command

Condition

RESP2 5

6 7 8 11 12 13 14

16

17

18

19

20 21

22

23

25 26

30

31

32

Meaning PENDSTATUS or NOTPENDING was specified for a connection that is not APPC or IRC PURGE was specified for connection that is not VTAM PURGETYPE has an invalid CVDA value PENDSTATUS has an invalid CVDA value SET 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(datavalue) 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 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)

356

CICS TS for z/OS: CICS Users Handbook

Command

Condition

RESP2 35 36

37

44 45 46 SYSIDERR IOERR NORMAL NORMAL NOTAUTH 9 10 58 59 100

SET CORBASERVER

INVREQ

2 ?

NOTAUTH

100

NOTFND SET DB2CONN INVREQ

1 1 2 3 4 5 6 7 9 10 11 12 13 14 15 16 17 18 19 20 21 22 23 24

Meaning 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 The user associated with the issuing task is not authorized to use this command The specified session bean timeout value is invalid The CorbaServer state is not INSERVICE The user associated with the issuing task is not authorized to use this command The named CorbaServer was not found 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

Chapter 9. RESP2 values and their meanings

357

Command

Condition

RESP2 25

26 27 28

29

Meaning STANDBYMODE(NOCONNECT) and CONNECTERROR(SQLCODE) specified or CONNECTERROR(SQLCODE) specified when STANDBYMODE is NOCONNECT Both PLAN and PLANEXITNAME specified Invalid ACCOUNTREC value COMTHREADLIM exceeds TCBLIMIT or COMTHREADLIM > 2000 or COMTHREADLIM < 0 PURGE CYCLE is too low; that is, < 30 seconds 1. or PURGE CYCLE minutes < 0 2. or PURGE CYCLE seconds < 0 3. or PURGE CYCLE minutes > 59 4. or PURGE CYCLE seconds > 59 TCBLIMIT > 2000 or TCBLIMIT < 4 THREADLIMIT exceeds TCBLIMIT or THREADLIMIT > 2000 or THREADLIMIT < 3 Already connected DB2 not active Insufficient authorization Connection error Invalid INIT parms DB2ID cannot be set, CONN active DB2CONN partially discarded SET NOTCONNECTED when the FORCE or WAIT option has been specified, but this transaction is itself using the CICS DB2 interface Bad characters in DB2GROUPID Both DB2ID and DB2GROUPID specified DB2GROUPID cannot be set, connection active Invalid RESYNCMEMBER option 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

32 33

34 39 40 41 42 43 44 46

| | | | | #
NORMAL

47 48 49 54 38

NOTFND NOTAUTH

1 100 102 103 2 3 4 5 7 8 9 10

SET DB2ENTRY

INVREQ

358

CICS TS for z/OS: CICS Users Handbook

Command

Condition

RESP2 11 12 13 14 15

16 17

18 19

NOTAUTH

NOTFND SET DB2TRAN INVREQ

100 101 102 103 1 2 3 4 100 101 102 103 1 1 2 3 4 5 6 7 8 100

NOTAUTH

NOTFND SET DELETSHIPPED INVREQ

NOTAUTH

SET DSNAME

DSNNOTFOUND

1 15 3 10

INVREQ

Meaning 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 THREADLIMIT > 2000 or THREADLIMIT < 0 or THREADLIMIT > TCBLIMIT Invalid ACCOUNTREC value SET DISABLED when the FORCE ir WAIT option has been specified, but this transaction itself is using the DB2ENTRY Command authorization failure Resource authorization failure Surrogate authorization failure AUTHTYPE authorization failure There is no DB2ENTRY currently installed with the specified name Bad characters in TRANSID name TRANSID already exisits in another installed DB2TRAN Bad characters in DB2ENTRY name Command authorization failure Resource authorization failure Surrogate authorization failure AUTHTYPE authorization failure There is no DB2TRAN currently installed with the specified name INTERVAL value is invalid INTERVALHRS value is not in the range 0-99 INTERVALMINS value is invalid INTERVALSECS value is invalid 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

Chapter 9. RESP2 values and their meanings

359

Command

Condition

RESP2 12

13

14

16

17

18

19

29

30 31 33 34

36

39

Meaning 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 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 AVAILABILITY, QUIESCESTATE, RESETLOCKS or RETRY is specified for a data set that is a BDAM data set

360

CICS TS for z/OS: CICS Users Handbook

Command

Condition

RESP2 40

41

42 43

Meaning 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: v For QUIESCED this would result in a deadlock v 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 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

44

46 47

IOERR

20

21

35 40 48

49

Chapter 9. RESP2 values and their meanings

361

Command

Condition SUPPRESSED

RESP2 37

Meaning A QUIESCESTATE value of QUIESCED or IMMQUIESCED is specified, but the quiesce of the data set is cancelled by another participating CICS region. This could be for one of the following reasons: v A user issued a SET DSNAME UNQUIESCED command v AN XCFVSDS global user exit program suppressed the quiesce v 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 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

38

NOTAUTH

100

SET DUMPDS

INVREQ

1 2 3

IOERR NOTAUTH

4 100

SET ENQMODEL

INVREQ

IOERR NOTFND NOTAUTH

3 4 1 100

SET FILE

INVREQ

1 2 3 4 5 6 7 8

362

CICS TS for z/OS: CICS Users Handbook

Command

Condition

RESP2 9 10 11

12 13 14 16 17 19 20 21

22

23 24 28

29 30 31

32 33 34

35

36 37 39

Meaning EMPTYSTATUS has an invalid CVDA value LSRPOOLID was specified for a non-VSAM data set LSRPOOLID is not in the range 18, or the corresponding buffer is not defined READ has an invalid CVDA value STRINGS value is not in the range 1255, 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 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

Chapter 9. RESP2 values and their meanings

363

Command

Condition

RESP2 40

41

42

43

44

45

46

47

48

49

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

364

CICS TS for z/OS: CICS Users Handbook

Command

Condition

RESP2 50

51 52 53

54

Meaning 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 A file open request cannot be satisfied because of one of the following reasons: v 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 v 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 v 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 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: v The file attributes do not match those specified when the CFDT was created, or v A KEYLENGTH or RECORDSIZE has been specified that exceeds the maximum supported

55 56 57

58

59

60 61

62 63

Chapter 9. RESP2 values and their meanings

365

Command

Condition

RESP2 64

65 66 67

FILENOTFOUND NOTAUTH

69 18 100

101

IOERR

SET IRC

INVREQ

1 2 4 5 6

18

NOSTG

9 10 11

IOERR

12 13 14

Meaning 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 DSNAME is invalid The named 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 OPEN has failed in VSAM, and the RESP2 field contains a VSAM response code CLOSE has failed in VSAM, and the RESP2 field contains a VSAM response code A program required for IRC, DFHCRSP, is unavailable OPENSTATUS has an invalid CVDA value CICS was initialized without IRC support (ISC=NO) No connection has been defined The VTAM APPLID for this CICS is blanks; IRC requires a non-blank APPLID Another CICS using IRC has the same VTAM APPLID as this one; unique names are required IRC rejected the open of this CICS because it had already reached the maximum number of logons IRC support (the DFHIRP module) is below the level required by this CICS system CICS storage is insufficient for the request MVS storage is insufficient (SVC block request rejected) 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

366

CICS TS for z/OS: CICS Users Handbook

Command

Condition NOTAUTH

RESP2 15 100

SET JOURNALNAME

JIDERR

1 2

INVREQ

2 3 4 5 n

IOERR

NOTAUTH

100

101

SET JVMPOOL

INVREQ

1 2

NOTAUTH

100

SET MODENAME

SYSIDERR

1 2 3 4 5 6 7 8

INVREQ

Meaning 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 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 TERMINATE is specified with an invalid CVDA value STATUS is specified with an invalid CVDA value The user associated with the issuing task is not authorized to use this 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

367

Command

Condition

RESP2 9 100

NOTAUTH

SET MONITOR

INVREQ

1 2 3 4 5 6 7

8 9 10 NOTAUTH 100

SET NETNAME

INVREQ

27 29 100

NOTAUTH

SET PROCESSTYPE

INVREQ

2 3 5 6

NOTAUTH

100

PROCESSERR

SET PROGRAM

INVREQ

Meaning ACQUIRED was specified but CICS is not in session on this connection The user associated with the issuing task is not authorized to use this command STATUS has an invalid CVDA value PERFCLASS has an invalid CVDA value EXCEPTCLASS has an invalid CVDA value EVENTCLASS has an invalid CVDA value CONVERSEST has an invalid CVDA value SYNCPOINTST has an invalid CVDA value The FREQUENCY value is invalid v 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 The process-type is not disabled, and therefore cannot be enabled You have specified an invalid CVDA value on the AUDITLEVEL option You have specified an invalid CVDA value on the STATUS option You have specified a value of FULL, PROCESS, or ACTIVITY on the AUDITLEVEL option, but the AUDITLOG attribute of the PROCESSTYPE definition does not specify an audit log The user associated with the issuing task is not authorized to use this command The process-type named in the PROCESSTYPE option is not defined in the process-type table (PTT) DISABLED or DPLSUBSET was specified for a program beginning DFH STATUS has an invalid CVDA value

368

CICS TS for z/OS: CICS Users Handbook

Command

Condition

RESP2 3 4 5 6

9 17

18

19

20 22 23 24 25 PGMIDERR IOERR NOTAUTH 7 8 100

101

SET STATISTICS

INVREQ

1 2 3 4 5 6 7

Meaning 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 RUNTIME has an invalid CVDA value JVM was specified but no JVMCLASS has been supplied DEBUG was specified but RUNTIME was not set to JVM JVMCLASS contains embedded blanks or null (x00) characters 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 The user associated with the issuing task is not authorized to access this particular resource in the way required by this command The INTERVAL value is out of range The ENDOFDAY value is out of range RECORDING has an invalid CVDA value The INTERVALHRS value is out of range The INTERVALMINS value is out of range The INTERVALSECS value is out of range More than one of the interval values has been used and the combination either exceeds 24 hours or is less than 1 minute The ENDOFDAYHRS value is out of range

Chapter 9. RESP2 values and their meanings

369

Command

Condition

RESP2 9 10 11

NOTAUTH

100

SET SYSDUMPCODE

NOTFND INVREQ

1 2 4 5 6 7 9 13 14 15

DUPREC IOERR

10 11

NOSPACE

12

NOTAUTH

100

SET SYSTEM

INVREQ

1 3 5 6 7 9 12 13 14 15 20 21

Meaning 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 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 1003600000 The RUNAWAY value is out of range MROBATCH is not in the range 1255 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 065535 SCANDELAY is not in the range 05000 DSALIMIT is not in the range 2MB to 16MB EDSALIMIT is not in the range 10MB to 2GB

370

CICS TS for z/OS: CICS Users Handbook

Command

Condition

RESP2 22 23 29 30

LENGERR NOSTG

20 16

NOTAUTH

100

NOTSUPERUSER

15

SET TASK

TASKIDERR

1 2

INVREQ

3 4 5

NOTAUTH

100

SET TCLASS

TCIDERR INVREQ NOTAUTH

1 2 100

SET TCPIP

INVREQ

4 5 6 11 12

NORMAL

14

NOTAUTH

100

Meaning There is insufficient MVS storage to allocate DSALIMIT There is insufficient MVS storage to allocate EDSALIMIT The LOGDEFER value is out of range MAXSOCKETS is not in the range 1 through 65535 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 CICS was unable to set MAXSOCKETS to the value requested, because the userid under which the CICS job is running does not have superuser authority 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 0255 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 0999 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 TCPIP has been opened, but some TCPIPSERVICEs have not been opened because the MAXSOCKETS limit has been reached The user associated with the issuing task is not authorized to use this command

Chapter 9. RESP2 values and their meanings

371

Command

Condition NOTSUPERUSER

RESP2 15

SET TCPIPSERVICE

INVREQ

4 5 7 8 9 10 11

12 14

NOTFND NOTAUTH

3 100

SET TDQUEUE

QIDERR INVREQ

1 2 3 4 5 6 7 8 9 10 12 13 15 16

18 19 20 21

Meaning CICS was unable to set MAXSOCKETS to the value requested, because the userid under which the CICS job is running does not have superuser authority 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 TCPIPSERVICE has not been opened because the MAXSOCKETS limit has been reached 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 TRIGGERLEVEL was specified for an extrapartition queue The TRIGGERLEVEL value is not in the range 032767 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

372

CICS TS for z/OS: CICS Users Handbook

Command

Condition

RESP2 22 30 31 35 40

IOERR

14

17

NOTAUTH

23 24 25

27

100

101

102

USERIDERR SET TERMINAL INVREQ

28 1

2 4 5 6 7 9 11

Meaning The ESM did not respond Disabled pending condition SET not possible because the queue was not disabled 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 Administrators 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 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

Chapter 9. RESP2 values and their meanings

373

Command

Condition

RESP2 13 15 17 18 21 22 24 25 26

27 28 29

31 33 34

35 36 37 38 39 40 41 42 43 44

Meaning SERVSTATUS has an invalid CVDA value TERMPRIORITY value not in range 0255 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 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

374

CICS TS for z/OS: CICS Users Handbook

Command

Condition

RESP2 45

46 48

50 51 52

54 57 NORMAL 53 58 59 60

TERMIDERR NOTAUTH

23 100

SET TRACEDEST

INVREQ

1 2 3 4 5 6 11

IOERR

10

NOSPACE NOSTG

7 8 9

NOTAUTH

100

Meaning Options would result in the invalid combination of the alternate printer being defined without a primary printer defined OBFORMATST is specified for a console or 3790 Options would result in the invalid combination of the printer copy status being set without a primary printer defined VTAM not available for VTAM terminal PRINTER and ALTPRINTER option specified for a non-3270 terminal PRTCOPYST of ALTPRTCOPST option specified for a non-3270 terminal Option other than PURGETYPE specified for IRC session Other SET parameters were included with the CANCEL option Purge deferred AIDs are successfully canceled No AIDs are canceled MAPNAME or MAPSETNAME specified, but the terminal is not of a type supported by BMS The named terminal cannot be found The user associated with the issuing task is not authorized to use this command INSTATUS has an invalid CVDA value A TABLESIZE value of < 1 has been specified AUXSTATUS has an invalid CVDA value SWITCHSTATUS has an invalid CVDA value 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

Chapter 9. RESP2 values and their meanings

375

Command SET TRACEFLAG

Condition INVREQ

RESP2 1 2 3 4 5

NOTAUTH

100

SET TRACETYPE

NOTFND

NOTAUTH

100

SET TRANCLASS

INVREQ

2 3

NOTAUTH

100

TCIDERR SET TRANDUMPCODE NOTFND INVREQ

1 1 2 3 4 5 6 7 9 13 14 10 11

DUPREC IOERR

NOSPACE

12

NOTAUTH

100

SET TRANSACTION

TRANSIDERR

Meaning SYSTEMSTATUS has an invalid CVDA value USERSTATUS has an invalid CVDA value SINGLESTATUS has an invalid CVDA value TCEXITSTATUS has an invalid CVDA value TCEXITSTATUS is specified but VTAM is not installed The user associated with the issuing task is not authorized to use this command At least one CICS component was not accessible. Trace levels were set for the other components The user associated with the issuing task is not authorized to use this command The MAXACTIVE value is not in the range 0-999 The PURGETHRESH value is not in the range 0-1000000 The user associated with the issuing task is not authorized to use this command The transaction class cannot be found The dump code cannot be found ACTION has an invalid CVDA value TRANDUMPING has an invalid CVDA value SYSDUMPING has an invalid CVDA value The MAXIMUM value is out of range SHUTOPTION has an invalid CVDA value REMOVE is specified with other options The dump code is invalid DUMPSCOPE has an invalid CVDA value RELATED requires MVS/ESA 5.1 ADD is specified for a dump code already in the transaction dump table An error occurred updating the CICS catalog. The entry is changed for the current run, but is not recorded for restarts The CICS catalog is full. The entry is changed for the current run, but is not recorded for restarts The user associated with the issuing task is not authorized to use this command The transaction cannot be found

376

CICS TS for z/OS: CICS Users Handbook

Command

Condition INVREQ

RESP2 2 3 4 5 7 8 9 10 11 12 13

NOTAUTH

14 100

101

SET TSQUEUE/TSQNAME

NOTFND INVREQ

1 1

Meaning 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 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 Server error 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 QIDERR SYSIDERR 0 1 0

3 4 5 100

NOTAUTH

101

Chapter 9. RESP2 values and their meanings

377

Command SET UOW

Condition UOWNOTFOUND INVREQ

RESP2 1 3 4

NOTAUTH SET UOWLINK UOWLNOTFOUND INVREQ

100 1 2

5 6 7

NOTAUTH SET VOLUME VOLIDERR

100 1

SET VTAM

INVREQ

1 2 4 5 6 7 8 9

Meaning 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 The use of this command is not authorized The specified UOW-link cannot be found Resynchronization is already in progress, or the UOW-link is already being processed by another instance of the SET UOWLINK command The UOW is in-doubt, and the UOW-link is the coordinator of the commit or backout session. The UOW must be forced using the SET UOW command before the UOW-link can be deleted This is not a link created by a connection, or is not a recoverable link The UOW-link (and the associated communication session) is still active ACTION has an invalid CVDA value The UOW-link has a suitable connection definition, and cannot be deleted. You must discard the related connection before you can delete a UOW link The use of this command is not authorized The program has issued a SET VOLUME command. This command is wthdrawn VTAM is not present in the system OPENSTATUS has an invalid CVDA value 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

378

CICS TS for z/OS: CICS Users Handbook

Command

Condition

RESP2 10

11

12

13

14

16

IOERR

NOTAUTH

100

SET WEB

INVREQ

11

NOTAUTH

100

SIGNOFF

INVREQ

1 2 3 4

Meaning 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 CICS is performing cleanup processing following a predatory XRF takeover. CICS rejects OPEN requests with this error, without invoking VTAM, during this activity. OPEN requests are processed as usual as soon as cleanup is complete Your attempt to deregister CICS from a VTAM generic resource failed because CICS is not registered as a member of a generic resource group An error occurred during the opening of the ACB. If CICS could not process the request, the RESP2 value is 3. If VTAM detects the failure, CICS returns the VTAM FDBK2 code in RESP2: you can look up these errors in the VTAM Programming manual, under ACB OPEN and CLOSE return codes The user associated with the issuing task is not authorized to use this command An invalid value has been supplied for STATUS, GARBAGEINT or TIMEOUTINT The user associated with the issuing task is not authorized to use this command No user is currently signed on There is no terminal with this task This tasks terminal has preset security Signoff is attempted using transaction routing without using the CRTE transaction

Chapter 9. RESP2 values and their meanings

379

Command

Condition

RESP2 18 200

SIGNON

NOTAUTH

1 2 3 4 5 6 16 17 19 20 21 22 23 24

INVREQ

9 10 11 12 13

14 15

18 25 26 27 28 29 200

USERIDERR

8 30

Meaning The CICS ESM interface not initialized Command not allowed for a distributed program link server program A password is required The supplied password is wrong A new password is required The new password is not acceptable An OIDCARD is required The supplied OIDCARD is wrong The USERID is not authorized to use this terminal The USERID is not authorized to use the application The USERID is revoked The USERIDs 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 tasks terminal has preset security 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 An error occurred during SNSCOPE checking 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

380

CICS TS for z/OS: CICS Users Handbook

Command SPOOLCLOSE

Condition INVREQ

RESP2 4 8 40

NOSPOOL

4 8 12 8 1024

NOTOPEN NOTFND

SPOOLOPEN INPUT

ILLOGIC INVREQ

3 4 8 16 36 40

NOSPOOL

4 8 12 4

NOTFND

1024

NOTOPEN

OPENERR

1024 4

SPOLBUSY

4 8

SPOOLOPEN OUTPUT

INVREQ

4 8 16 20 36

Meaning 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 Interface has been stopped Dataset has not been opened Input or output function has been corrupted, and SPOOLCLOSE could not complete Invalid CLASS value specified Unsupported language Unsupported function USERID missing INPUT|OUTPUT missing Subsystem interface already enabled Note: Errors 1024 and over are internal and should not occur. If one of these error codes is returned, contact your IBM support center. No subsystem present Interface being disabled; CICS is quiescing Interface has been stopped No data sets could be located for retrieval for the specified external writer name Input or output function has been corrupted, and SPOOLCLOSE could not complete Data set has not been opened or a task which has not issued the SPOOLOPEN for a spool data set has attempted to access it. Subtask OPEN macro failure 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 Unsupported language Unsupported function USERID missing NODE missing INPUT|OUTPUT missing

Chapter 9. RESP2 values and their meanings

381

Command

Condition

RESP2 40

44 48

52

NOSPOOL

4 8 12 4

NOTFND

NOTOPEN OPENERR

8 1024 4

SPOLBUSY

4 8

SPOOLREAD

ILLOGIC INVREQ

3 4 8 12 24 40

NOSPOOL

4 8 12 4

NOTFND

NOTOPEN

SPOLBUSY

8 12 1024 4 8

SPOOLWRITE

INVREQ

4 8 28

Meaning Subsystem interface already enabled Note: Errors 1024 and over are internal and should not occur. If one of these error codes is returned contact your IBM support center. Error in the OUTDESCR string OUTDESCR specified but function not available (wrong level of MVS or JES) OUTDESCR specified but bad pointer found on keyword or in OUTDESCR condition No subsystem present Interface being disabled; CICS is quiescing Interface has been stopped No data sets could be located for retrieval for the specified external writer name Data set has not been opened Subtask OPEN macro failure A VSAM SHOWCB macro failed to return the lengths of the VSAM control blocks used to access the JES spool file. Interface already in use by another task Interface already in use by current task Invalid CLASS value specified Unsupported language Unsupported function Read attempt after end of file INTO missing Subsystem interface already enabled. Note: Errors 1024 and over are internal, and should not occur. If one of these error codes is returned, contact your IBM support center. No subsystem present Interface being disabled; CICS is quiescing Interface has been stopped No data sets could be located for retrieval for the specified external writer name Data set has not been opened Attempt to read an output file Subtask OPEN macro failure Interface already in use by another task Interface already in use by current task Unsupported language Unsupported function FROM missing

382

CICS TS for z/OS: CICS Users Handbook

Command

Condition

RESP2 40

NOSPOOL

4 8 12 8 16 1024 4 8

NOTOPEN

SPOLBUSY

START

INVREQ

4 5 6 17

18

NOTAUTH

7 9

# # #

RESUNAVAIL

USERIDERR

8 10

START ATTACH

INVREQ

11 12 7 11 11 12 18

NOTAUTH TRANSIDERR START BREXIT INVREQ

NOTAUTH

7 9

Meaning Subsystem interface already enabled. Note: Errors 1024 and over are internal, and should not occur. If one of these error codes is returned, contact your IBM support center. No subsystem present Interface being disabled; CICS is quiescing Interface has been stopped Spool report has not been opened Attempt to write an input file Subtask OPEN macro failure Interface already in use by another task Interface already in use by current task Hours are out of range Minutes are out of range Seconds are out of range The STARTed transaction is not shutdown-enabled, and the CICS region is in the process of shutting down 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) An XICERES globaluser exit program has indicated that a required resource is unavailable on the target region. 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 An attempt was made to route a START ATTACH request A START ATTACH request has failed A resource security check fails on TRANSID(name) The specified transaction is defined as remote An attempt was made to route a START BREXIT request A START BREXIT request has failed A USERID is specified and the CICS external security manager is not initialized A resource security check fails on TRANSID(name) A surrogate user security check fails on USERID(name)

Chapter 9. RESP2 values and their meanings

383

Command

Condition TRANSIDERR USERIDERR

RESP2 11 8 10

STARTBR

FILENOTFOUND

INVREQ

20

25

26

33

42

44 51

DISABLED NOTOPEN

50 60

ISCINVREQ

70

NOTFND

80

NOTAUTH

101

Meaning The specified transaction is defined as remote 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 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 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)

384

CICS TS for z/OS: CICS Users Handbook

Command

Condition LOADING

RESP2 104

ILLOGIC

110

IOERR SYSIDERR

120 130

131

132

SYNCPOINT

INVREQ

200

SYNCPOINT ROLLBACK

INVREQ

200

UNLOCK

FILENOTFOUND

INVREQ

47

48

DISABLED NOTOPEN

50 60

ISCINVREQ

70

NOTAUTH ILLOGIC (VSAM and CICS-maintained data tables) IOERR

101 110

120

Meaning A STARTBR was issued to a user-maintained data table that is currently being loaded 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. For a coupling facility data table, the connection to the coupling facility data table server has failed The start browse is operating on a coupling facility data table that no longer exists 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 An attempt is made to function-ship a request which includes a TOKEN keyword 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 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

Chapter 9. RESP2 values and their meanings

385

Command

Condition SYSIDERR

RESP2 130

131

132

UPDATE COUNTER

INVREQ

201 301

303

304

305

306 308

309

310

403 404

SUPPRESSED

406 103

VERIFY PASSWORD

NOTAUTH

USERIDERR

2 3 19 8

Meaning The SYSID option specified a name that is neither the local nor a remote system (made known to CICS by defining a CONNECTION); or the link to the remote system is closed. For a coupling facility data table, the connection to the coupling facility data table server has failed The UNLOCK is issued against a coupling facility data table that no longer exists Named counter not found The server has reported an error code that is not understood by the named counter interface An unexpected error, such as structure failure or loss of connectivity, has occurred on a macro used to access the coupling facility The pool selection parameter specified in the program cannot be resolved to a valid server name using the current options table The interface is unable to establish a connection to the server for the selected named counter pool An abend occurred during server processing of a request The DFHNCOPT options table module, required for resolving a pool name, could not be loaded During processing of the options table, the named counter interface encountered an unknown entry format An options table entry matching the given pool name specified a user exit program, but the user exit program is not link-edited with the options table and cannot be loaded The POOL parameter contains invalid characters or embedded spaces The COUNTER parameter contains invalid characters or embedded spaces The VALUE parameter is invalid The current value of the named counter is not within the range specified by the COMPAREMAX and COMPAREMIN parameters, when both are specified, or greater that the COMPAREMAX parameter or less than the COMPAREMIN parameter, when only one option is specified The supplied password is wrong A new password is required The USERID is revoked The USERID is not known to the external security manager

386

CICS TS for z/OS: CICS Users Handbook

Command

Condition INVREQ

RESP2 13

18 29 32 WAIT CONVID INVREQ 200

WAIT EVENT

INVREQ

2 3

4 6

WAIT EXTERNAL

INVREQ

1 2 3 4 5

WAIT TERMINAL

INVREQ

200

WAITCICS

INVREQ

1 3 4 5

WEB ENDBROWSE FORMFIELD

INVREQ

Meaning 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 Command not supported for distributed program link when it refers to the principal facility The ECB address is a null pointer, (X'00000000') or (X'FF000000') The specified event control area address is above the 16MB line for programs executing in 24-bit mode The event control area address is not aligned on a fullword boundary The timer-event control area specified on a WAIT EVENT is in use-key task-lifetime storage, and is inaccessible to another transaction. This condition can only occur if the storage for the timer-event control area is obtained other than by an EXEC CICS POST command, and is for posting as an ECB by some other task on completion of an event An ECB is not valid, for example the ECB is not fullword aligned An ECB is already being waited on NUMEVENTS is not a positive number PURGEABILITY is specified with an incorrect CVDA No valid ECBs have been found in the list because either the ECBLIST address is not valid or all the ECB addresses are not valid A distributed program link server application specified the function-shipping session (its principal facility) on the CONVID option An ECB is not valid, for example the ECB is not fullword aligned NUMEVENTS is not a positive number PURGEABILITY is specified with an incorrect CVDA No valid ECBs have been found in the list, because either the ECBLIST address is not valid, or all the ECB addresses are not valid The command is being issued in a non-CICS Web application

Chapter 9. RESP2 values and their meanings

387

Command

Condition

RESP2 3 4

WEB ENDBROWSE HTTPHEADER

INVREQ

1 3 4

WEB EXTRACT

INVREQ

1 3

LENGERR

4 5 6 8

WEB READ FORMFIELD

INVREQ

1 3 11 12 13 14

LENGERR

1 2

NOTFND WEB READ HTTPHEADER INVREQ

1 1 3

LENGERR

1 2

NOTFND WEB READNEXT FORMFIELD INVREQ

1 1

Meaning The command is being issued for a non-HTTP request The command is being issued before a WEB STARTBROWSE command is issued The command is being issued in a non-CICS Web application The command is being issued for a non-HTTP request The command is being issued before a WEB STARTBROWSE command is issued The command is being issued in a non-CICS Web application The command is being issued for a non-HTTP request The length in METHODLENGTH is less than or equal to zero The length in VERSIONLEN is less than or equal to zero The length in PATHLENGTH is less than or equal to zero The length in QUERYSTRLEN is less than or equal to zero The command is being issued in a non-CICS Web application The command is being issued for a non-HTTP request The client codepage cannot be found The server codepage cannot be found No forms data has been supplied in the body of the HTTP request The codepage combination for client and server is invalid The length in VALUELENGTH is less than or equal to zero The form field value has been truncated during a read operation because the receiving buffer is too small The form field with the given name cannot be found The command is being issued in a non-CICS Web application The command is being issued for a non-HTTP request The length in VALUELENGTH is less than or equal to zero The header value has been truncated during a read operation because the receiving buffer is too small The header with the given name could not be found The command is being issued in a non-CICS Web application

388

CICS TS for z/OS: CICS Users Handbook

Command

Condition

RESP2 3 4

6 LENGERR 1 4

WEB READNEXT HTTPHEADER

INVREQ

1 3 4 6

LENGERR

1 4

WEB RECEIVE

INVREQ LENGERR

1 1 2 7

NOTFND

WEB RETRIEVE

INVREQ

1 2

WEB SEND

INVREQ NOTFND

1 1 7

WEB STARTBROWSE FORMFIELD

INVREQ

1 3

Meaning The command is being issued for a non-HTTP request The command is being before a WEB STARTBROWSE FORMFIELD has been issued A form field has been found that is not in the format NAME:VALUE NAMELENGTH or VALUELENGTH is less than or equak to zero The form field name has been truncated during a browse operation because the receiving buffer is too small The form field value has been truncated because the receiving buffer is too small The command is being issued in a non-CICS Web application The command is being issued for a non-HTTP request The command is being before a WEB STARTBROWSE has been issued A form field has been found that is not in the format NAME:VALUE NAMELENGTH or VALUELENGTH is less than or equak to zero The form field name has been truncated during a browse operation because the receiving buffer is too small The form field value has been truncated because the receiving buffer is too small The command is being issued in a non-CICS Web interface application The length is negative The length is positive and exceeds the programs maximum Either HOSTCODEPAGE or CLNTCODEPAGE parameter specifies an invalid codepage The command is issued in a non-CICS Web interface application A WEB SEND command has not been issued The command is being issued in a non-CICS Web interface application The document has not been created or the name is incorrectly specified The specified CLNTCODEPAGE is not recognised or is incorrectly specified The command is being issued in a non-CICS Web application The command is being issued for a non-HTTP request

Chapter 9. RESP2 values and their meanings

389

Command

Condition

RESP2 5 11 12 13 14

LENGERR NOTFND

1 1

WEB STARTBROWSE HTTPHEADER

INVREQ

1 3

WEB WRITE WRITE

INVREQ FILENOTFOUND LENGERR

1 1 10

12

14

INVREQ

20

23

26

38

40 44

51

Meaning There is already a WEB STARTBROWSE in progress The client codepage cannot be found The server codepage cannot be found No forms data has been supplied in the body of the HTTP request The codepage combination for client and server is invalid NAMELENGTH or VALUELENGTH is less than or equal to zero The form field name given in the FORMFIELD parameter could not be found The command is being issued in a non-CICS Web application The command is being issued for a non-HTTP request The command is being issued in a non-CICS Web application The file name referred to in the FILE option cannot be found in the FCT 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 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

390

CICS TS for z/OS: CICS Users Handbook

Command

Condition

RESP2 56

DISABLED NOTOPEN

50 60

ISCINVREQ

70

NOSPACE

100

102

103

108

NOTAUTH LOADING

101 104

SUPPRESSED

105

LOCKED

106

RECORDBUSY

107

ILLOGIC

110

IOERR

120

Meaning An attempt to update a recoverable coupling facility data table has failed because the current unit of work has already updated 1024 recoverable coupling facility data tables 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 There is insufficient space in the coupling facility data table pool to store the record A resource security check has failed on FILE(filename) 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

Chapter 9. RESP2 values and their meanings

391

Command

Condition SYSIDERR

RESP2 130

131

132

DUPREC

150

WRITE OPERATOR

INVREQ

EXPIRED LENGERR

1 2 3 4 5 6 7 8

WRITEQ TS

IOERR LOCKED

5 0

NOTAUTH SYSIDERR

101 4

XCTL

PGMIDERR

Meaning The SYSID option specified a name that is neither the local nor a remote system (made known to CICS by defining a CONNECTION); or the link to the remote system is closed. For a coupling facility data table, the connection to the coupling facility data table server has failed The WRITE is issued against a coupling facility data table that no longer exists 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 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 operators reply was received The reply was longer than MAXLENGTH, and has been truncated There is an irrecoverable input/output error for a shared queue The request cannot be performed because use of the queue has been restricted owing to a unit of work failing in-doubt A resource security check has failed on QUEUE(name) The CICS region in which the temporary storage command is executed fails to connect to the TS server managing the TS pool that supports the referenced temporary storage queue 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

392

CICS TS for z/OS: CICS Users Handbook

Command

Condition

RESP2 3

Meaning 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 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 has been attempted to a hot-pooled Java program object while there is already a hot-pooled program on the stack 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 The COMMAREA address passed was zero, but LENGTH was non zero INPUTMSGLEN was less than 0 or greater than 32767

9 21

22

23 24

INVREQ

29 30 43

200

LENGERR

11 26 27

Chapter 9. RESP2 values and their meanings

393

Command

Condition

RESP2 28

NOTAUTH

101

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

394

CICS TS for z/OS: CICS Users Handbook

Chapter 10. EXEC interface block (EIB) response and function codes
This appendix lists the response codes and the function codes of EXEC CICS commands.

Response codes of EXEC CICS commands


After the execution of an EXEC CICS command, fields EIBRESP and EIBRCODE are set to indicate whether the command executed successfully, or whether a CICS condition was raised. Each possible value of EIBRESP relates directly to a specific condition, no matter which command caused the condition to be raised. This is not true for EIBRCODE values: both the value and the byte of EIBRCODE in which it is set depend on which command was issued. The following sections list the conditions that are applicable to the EXEC CICS commands described in this book, their corresponding RESP values (decimal), the associated EIBRCODE values (hexadecimal), and the transaction abend codes (if any).

EXEC CICS DISCARD, INQUIRE, PERFORM, and SET commands


The first word of EIBRCODE for these commands is always set equal to the hexadecimal equivalent of the RESP value; the remaining bytes are set to X'00'.
Condition (Byte 3) 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
Copyright IBM Corp. 1989, 2002

RESP Value code code 93 14 83 12 21 16 17 43 22 95 18 42 70 13 97 27 98 44 59 53 91 92 11 28 102 69

EIBRCODE 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

Abend AEX1 AEIN AEXK AEIL AEIU AEIP AEIQ AEYG AEIV AEX3 AEIR AEY7 AEIM AEX5 AEI0 AEX6 AEYH AEYQ AEXX AEX0 AEIK AEI1 AEYX

395

Condition (Byte 3) VOLIDERR

RESP Value code code 71

EIBRCODE 47

Abend AEXV

EXEC CICS DISABLE, ENABLE, and EXTRACT EXIT commands


Conditions that can be raised by the DISABLE, ENABLE, and EXTRACT EXIT commands are INVEXITREQ and NOTAUTH. There are no conditions associated with the RESYNC command.
Condition INVEXITREQ NOTAUTH RESP Value 63 70 EIBRCODE 80 46 Abend AEY0 AEY7

Function codes of EXEC CICS commands


The function code (field EIBFN) is a hexadecimal value that identifies the command most recently issued by a task. The format of the EIBFN field is as follows:
ASM COBOL PL/I C CL2 PIC X(2) CHAR (2) CHAR variable name(2);

The function codes of the commands described in this book are listed below in command sequence, then in function code sequence. For information about other function codes, see the CICS Application Programming Reference manual.
Command ACQUIRE TERMINAL COLLECT STATISTICS CREATE CONNECTION CREATE DB2CONN CREATE DB2ENTRY CREATE DB2TRAN CREATE DOCTEMPLATE CREATE ENQMODEL CREATE FILE CREATE JOURNALMODEL CREATE LSRPOOL CREATE MAPSET CREATE PARTITIONSET CREATE PARTNER CREATE PROCESSTYPE CREATE PROFILE CREATE PROGRAM CREATE REQUESTMODEL CREATE SESSIONS CREATE TCPIPSERVICE CREATE TDQUEUE CREATE TERMINAL CREATE TRANCLASS CREATE TRANSACTION CREATE TSMODEL CREATE TYPETERM DISABLE PROGRAM Code 86 02 70 08 30 0E 30 20 30 22 30 24 30 2E 30 2A 30 14 30 1E 30 16 30 04 30 06 30 18 30 26 30 0A 30 02 30 2C 30 12 30 30 30 1C 30 10 30 1A 30 08 30 28 30 0C 22 04

396

CICS TS for z/OS: CICS Users Handbook

Command DISCARD AUTINSTMODEL DISCARD CONNECTION DISCARD CORBASERVER DISCARD DB2CONN DISCARD DB2ENTRY DISCARD DB2TRAN DISCARD DJAR DISCARD DOCTEMPLATE DISCARD ENQMODEL DISCARD FENODE DISCARD FEPOOL DISCARD FEPROPSET DISCARD FETARGET 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 ENDBROWSE ACTIVITY ENDBROWSE CONTAINER ENDBROWSE EVENT ENDBROWSE PROCESS ENDBROWSE TIMER EXTRACT EXIT GETNEXT ACTIVITY GETNEXT CONTAINER GETNEXT EVENT GETNEXT PROCESS GETNEXT TIMER INQUIRE ACTIVITYID INQUIRE AUTINSTMODEL INQUIRE AUTOINSTALL INQUIRE AUXTRACE INQUIRE BEAN INQUIRE BRFACILITY INQUIRE CFDTPOOL INQUIRE CONNECTION INQUIRE CONTAINER INQUIRE CORBASERVER INQUIRE DB2CONN INQUIRE DB2ENTRY INQUIRE DB2TRAN INQUIRE DELETSHIPPED INQUIRE DISPATCHER

Code 42 10 58 10 B2 10 94 10 94 30 94 50 B2 30 9E 10 90 90 84 50 84 70 84 30 84 90 4C 10 92 10 60 10 44 10 96 10 46 10 4E 10 9A 10 9C 10 5C 10 52 10 5E 18 50 10 80 30 22 02 96 24 96 2A 96 36 96 36 96 3E 22 06 96 22 96 28 96 2E 96 34 96 34 96 12 42 02 68 12 78 02 B2 42 B402 98 02 58 02 96 14 B2 02 94 02 94 22 94 42 68 22 B602

Chapter 10. EXEC interface block (EIB) response and function codes

397

Command INQUIRE DJAR INQUIRE DOCTEMPLATE INQUIRE DSAS INQUIRE DSNAME INQUIRE DUMPDS INQUIRE ENQ INQUIRE ENQMODEL INQUIRE EVENT INQUIRE EXCI INQUIRE EXITPROGRAM INQUIRE FECONNECTION INQUIRE FENODE INQUIRE FEPOOL INQUIRE FEPROPSET INQUIRE FETARGET INQUIRE FILE INQUIRE GTFTRACE INQUIRE INTTRACE INQUIRE IRC INQUIRE JOURNALMODEL INQUIRE JOURNALNAME INQUIRE JVMPOOL INQUIRE LINE INQUIRE MODENAME INQUIRE MONITOR INQUIRE NETNAME INQUIRE PARTNER INQUIRE PROCESS INQUIRE PROCESSTYPE INQUIRE PROFILE INQUIRE PROGRAM INQUIRE REQID INQUIRE REQUESTMODEL INQUIRE RRMS INQUIRE STATISTICS INQUIRE STORAGE INQUIRE STREAMNAME INQUIRE SYSDUMPCODE INQUIRE SYSTEM 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

Code B2 22 9E 02 54 02 7A 02 66 02 90 22 90 82 96 16 7C 02 88 02 84 A2 84 42 84 62 84 22 84 82 4C 02 78 02 78 02 6E 02 92 02 60 12 92 02 7C 42 5A 02 70 12 52 02 44 02 96 18 96 02 46 02 4E 02 8A 02 9A 02 3A 02 70 02 5E 08 92 12 66 22 54 02 54 12 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

398

CICS TS for z/OS: CICS Users Handbook

Command INQUIRE TSMODEL INQUIRE TSPOOL INQUIRE TSQNAME INQUIRE TSQUEUE INQUIRE UOW INQUIRE UOWDSNFAIL INQUIRE UOWLINK INQUIRE VOLUME INQUIRE VTAM INQUIRE WEB PERFORM CORBASERVER PERFORM DELETSHIPPED PERFORM DJAR PERFORM DUMP PERFORM ENDAFFINITY PERFORM RESETTIME PERFORM SECURITY PERFORM SHUTDOWN PERFORM SNAP PERFORM STATISTICS RESYNC ENTRYNAME SET AUTOINSTALL SET BRFACILITY SET CONNECTION SET CORBASERVER SET DB2CONN SET DB2ENTRY SET DB2TRAN SET DELETSHIPPED SET DISPATCHER SET DSNAME SET DUMPDS SET ENQMODEL SET FILE SET IRC SET JOURNALNAME SET JOURNALNUM SET JVMPOOL SET MODENAME SET MONITOR SET NETNAME SET PROCESSTYPE SET PROGRAM SET STATISTICS SET SYSDUMPCODE SET SYSTEM SET TASK SET TCLASS SET TCPIP SET TCPIPSERVICE SET TDQUEUE SET TERMINAL SET TERMINAL SET TRACEDEST

Code 80 22 80 1A 80 12 80 02 90 02 90 62 90 42 62 02 68 02 9C 22 B2 06 68 26 B2 26 7E 04 58 06 72 02 64 02 76 02 7E 04 70 06 16 04 68 14 B404 58 04 B2 04 94 04 94 24 94 44 68 24 B604 7A 04 66 04 90 84 4C 04 6E 04 60 14 60 04 B0 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

Chapter 10. EXEC interface block (EIB) response and function codes

399

Command SET TRACEFLAG SET TRACETYPE SET TRANCLASS SET TRANDUMPCODE SET TRANSACTION SET TSQNAME SET TSQUEUE SET UOW SET UOWLINK SET VOLUME SET VTAM SET WEB STARTBROWSE ACTIVITY STARTBROWSE CONTAINER STARTBROWSE EVENT STARTBROWSE PROCESS STARTBROWSE TIMER

Code 78 14 78 24 5E 1C 66 14 50 04 80 14 80 04 90 04 90 44 62 04 68 04 9C 24 96 20 96 26 96 2C 96 32 96 3A

Code 16 04 22 02 22 04 22 06 30 0A 30 0C 30 0E 30 02 30 04 30 06 30 08 30 10 30 12 30 14 30 16 30 18 30 1A 30 1C 30 1E 30 20 30 22 30 24 30 26 30 28 30 2A 30 2C 30 2E 30 30 30 32 30 34 3A 02 42 02 42 10

Command RESYNC ENTRYNAME ENABLE PROGRAM DISABLE PROGRAM EXTRACT EXIT CREATE PROFILE CREATE TYPETERM CREATE CONNECTION CREATE PROGRAM CREATE MAPSET CREATE PARTITIONSET CREATE TRANSACTION CREATE TERMINAL CREATE SESSIONS CREATE FILE CREATE LSRPOOL CREATE PARTNER CREATE TRANCLASS CREATE TDQUEUE CREATE JOURNALMODEL CREATE DB2CONN CREATE DB2ENTRY CREATE DB2TRAN CREATE PROCESSTYPE CREATE TSMODEL CREATE ENQMODEL CREATE REQUESTMODEL CREATE DOCTEMPLATE CREATE TCPIPSERVICE CREATE CORBASERVER CREATE DJAR INQUIRE RRMS INQUIRE AUTINSTMODEL DISCARD AUTINSTMODEL

400

CICS TS for z/OS: CICS Users Handbook

Code 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 54 12 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

Command 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 DSAS SET SYSTEM INQUIRE SYSTEM 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

Chapter 10. EXEC interface block (EIB) response and function codes

401

Code 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 78 02 78 02 78 02 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 84 22 84 30 84 42 84 50 84 62 84 70 84 82 84 90 86 02 88 02 8A 02 90 02 90 04 90 22 90 42 90 44

Command 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 INQUIRE AUXTRACE INQUIRE INTTRACE INQUIRE GTFTRACE 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 INQUIRE FEPROPSET DISCARD FEPROPSET INQUIRE FENODE DISCARD FENODE INQUIRE FEPOOL DISCARD FEPOOL INQUIRE FETARGET DISCARD FETARGET ACQUIRE TERMINAL INQUIRE EXITPROGRAM INQUIRE REQID INQUIRE UOW SET UOW INQUIRE UOWENQ INQUIRE UOWLINK SET UOWLINK

402

CICS TS for z/OS: CICS Users Handbook

Code 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 96 20 96 22 96 24 96 26 96 28 96 2A 96 2C 96 2E 96 30 96 32 96 34 96 36 96 38 96 3A 96 3C 96 3E 98 02 9A 02 9A 10 9C 02 9C 04 9C 10 9C 12 9C 14 9C 22 9C 24 9E 02 9E 10 B0 02 B0 04 B2 02

Command 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 STARTBROWSE ACTIVITY GETNEXT ACTIVITY ENDBROWSE ACTIVITY STARTBROWSE CONTAINER GETNEXT CONTAINER ENDBROWSE CONTAINER STARTBROWSE EVENT GETNEXT EVENT ENDBROWSE EVENT STARTBROWSE PROCESS GETNEXT PROCESS ENDBROWSE PROCESS INQUIRE TIMER STARTBROWSE TIMER GETNEXT TIMER ENDBROWSE 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 INQUIRE JVMPOOL SET JVMPOOL INQUIRE CORBASERVER

Chapter 10. EXEC interface block (EIB) response and function codes

403

| | | |

Code B2 04 B2 06 B2 02 B2 22 B2 26 B2 30 B2 42 B402 B404 B602 B6 04

Command SET CORBASERVER PERFORM CORBASERVER DISCARD CORBASERVER INQUIRE DJAR PERFORM DJAR DISCARD DJAR INQUIRE BEAN INQUIRE BRFACILITY SET BRFACILITY INQUIRE DISPATCHER SET DISPATCHER

404

CICS TS for z/OS: CICS Users Handbook

Chapter 11. DFH messages


While CICS is running, it can produce several types of messages: v Console messages advise the system operator of execution progress, or request a decision. v Certain CICS-supplied support programs communicate directly with terminal operators. v CICS management modules and support programs log significant events and error occurrences to transient data destinations; for example, to the control system master terminal (CSMT), or to the CICS database control log (CDBC) for the CICS-DBCTL interface. v The CICS message switching program (DFHMSP) generates message switching responses (described in the CICS Supplied Transactions manual). v CICS directs informational macro notes (mnotes) to programmers (these are not documented). v 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 42 51 52 55 56 7x DFHSSIN DFHZCNR DFHCSDUP DFHCSDUP DFHCSDUP DFHCSDUP Command-level translators

The last two digits are assigned by CICS to identify the message or group of messages within an assembled program.

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 AD
Copyright IBM Corp. 1989, 2002

The abnormal condition program component The application deployment facility

405

AI AM AP AU BA BR CA CC CE CF CP CR CZ DB DD DM DS DU DX EJ EM ER EX FC FE IC II IN IR JC KC KE LD LG LM MC ME

The auto-install terminal model manager (AITM) The RDO allocation manager The application domain The transaction affinities utility The Business Application Manager (BAM) domain Bridging to 3270 transactions RDO command utility routine The CICS catalog domain (local and global) The sign on program component CICS coupling facility data tables server The CPI Communications component The ISC remote scheduler component The CICS class libraries domain The CICS database control component The directory manager The domain manager domain The dispatcher domain The dump domain The CICS database control component The Enterprise Java domain The Event Manager domain The user backout program The external CICS interface The file control component The FE terminal test program component The interval control program The IIOP domain The indoubt testing tool The interregion component The online journal control component The transaction/profile manager The kernel domain The loader domain The logger domain The lock manager domain The BMS message control program component The message domain

406

CICS TS for z/OS: CICS Users Handbook

MS MN MU MV NQ OT PA PC PD PG PR PS RD RM RP RS RT RU RX RZ SH SJ SK SM SN SO SR ST SZ TC TD TF TI TM TO TP TR

The load module scanner The monitor domain The message editing utility program The MVS RESMGR exit stub The enqueue manager domain The Object Transaction Service domain The parameter manager domain The program control program component The print dump exit routine DFHPDX The program manager domain The partner resource manager The system spooler interface control module component The RDO allocation manager The recovery Manager CICS ONC RPC The communications resynchronization program The ISC transaction routing component The recovery utility program The RRS-coordinated EXCI domain The Request Streams domain The Scheduler domain The JVM domain The sub task control program component The storage manager domain The signon component The CICS sockets domain The system recovery component The statistics domain The front end programming interface (FEPI) The terminal control program component The transient data component The terminal facility manager The timer domain The system termination program component The terminal object resolution program component The BMS terminal page retrieval program component The trace domain

Chapter 11. DFH messages

407

TS UP US WB XA XC XG XM XO XQ XS ZC ZE ZN

The temporary storage domain The measured usage license charging support macro The user domain The CICS Web Interface The XRF alternate component The XRF CICS availability manager The XRF general component The transaction manager The XRF CICS availability manager The shared temporary storage queue pool server The CICS security component The terminal control working set component The TCP error message writer component The syncpoint component

Thus the CICS message DFHAP0002 is issued from the application domain, identified by the two-character identifier AP.

Action codes
Certain messages (for example, DFHDB8208D) include an action code after the message identifier. Action codes give guidance to the operator of the type of action needed when the message appears on the system console. The following action codes are used: A D E I Immediate action (for example, mount a tape) Immediate decision (reply to a request, for example, enter GO or CANCEL) Eventual action is required, but does not have to be taken immediately No action required (If issued via the message domain, these messages can be suppressed by specifying MSGLVL=0 as a system initialization override.)

Severity codes
Certain messages, especially those associated with messages to terminal operators and messages which come from CICS utilities, have a severity code. (DFHST0210 I, is an example.) A severity code indicates to the operator whether a message is associated with an error, and if so, how serious it is. The following severity codes are used: E I W S Error. Something has gone wrong and action is required of the user before CICS processing can continue. Information only. No action is required. Warning. Something may have gone wrong, a program loop for example, but CICS processing continues. Severe error. Something serious has gone wrong and immediate action is required. CICS processing is suspended until action has been taken.

408

CICS TS for z/OS: CICS Users Handbook

Format of information
Information about each message is presented in the following format: v Message identifier in the form DFHnnnn or DFHccnnnn v Message text the words and inserts which make up the message as displayed in CICS v Explanation the events leading to or following the production of the message v System action the action that has been or will be taken by CICS v User response the action recommended for the user (the console or terminal operator or system programmer) v Destination the device or log to which the message is sent. This is one of the following: Console refers to a terminal type attached to CICS. (Route codes are 2 and 11 unless otherwise stated.) Terminal end user TERMCDBC terminals running the CDBC transaction. SYSPRINT (System printer) One of the following transient data queues: CADL VTAM resource definition log CAFF Transaction affinities utility messages CAIL Autoinstall terminal model manager (AITM) log CCPI Common programming interface for communications (CPI Communications) messages CDBC CICS-DBCTL interface log CDB2 CICS DB2 messages CDUL Transaction dump messages CMIG Migration log for messages reporting the use of functions that are no longer supported CPLD PL/I dumps CPLI PL/I sysprint output CRDI Log for installed resource definitions CRPO ONC RPC messages CSDL CEDA command log CSCS Sign on/off security log CSFL File allocation and related messages CSKL Log for transaction and profile resource definitions CSMT Write term errors and abends from DFHTACP and DFHACP CSPL Log for program resource definitions CSQL TDQUEUE messages CSRL Log for partner resource definitions CSSL Statistics log CSTL Term I/O error messages from DFHTACP CSML Sign on/off messages CSNE Terminal error messages issued from DFHZNAC. CSZL FEPI message queue CWBO 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.

Chapter 11. DFH messages

409

v 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 1 2 3 4 5 6 7 8 9 Meaning Master console action indicates a change in system status demanding operator action Master console information indicates a change in system status (system default) Tape pool status or other tape related information Direct access pool status or other related information Tape library information Disk library information Unit record pool information Teleprocessing control status System security checking Note: This route code suppresses the operators reply on the screen and on SYSLOG System error or maintenance information Programmer information for the MVS log

10 11

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 z/OS Installation Guide. When this facility is used, it affects messages displayed on MVS system consoles in the following ways: v The subsystem tries to ensure that all console messages issued by all CICS regions have a standard format. The standard format is:

410

CICS TS for z/OS: CICS Users Handbook

Column number:

1 | +DFHnnnn

13 | applid

22 | message-text

v v

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. The subsystem routine that reformats the messages does not receive control until after the message has been recorded in the CICS jobs 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 the EXEC CICS ABEND request does not specify an abend code.

Chapter 11. DFH messages

411

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.

Terminology
The terms abnormally terminates and abnormal termination are frequently used in a general sense to relate, as applicable, to one of the following: v The termination of CICS as a result of an MVS ABEND macro. (The term abend may also be used.) v The termination of a transaction (task) as a result of a CICS transaction ABEND macro.

MVS user abend 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


0108 0121 0123 0125 0126 0127 0147 0148 0149 0150 0151 0152 0161 0162 0170 0184 0185 0190 0191 0192 0193 0194 0195 0196 DFH5263 DFH5100 DFH5175 DFH5180 DFH5184 DFH5148 DFH5721 DFH5722 DFH5723 DFHER5724 DFHER5725 DFH5754 DFHAK5802 DFHAK5803 DFHPS5394 DFHJC4534 DFHJC4530 DFHXG6450 DFHXG6451 DFHXG6452 DFHXG6453 DFHXG6454 DFHXG6440 DFHXG6441

412

CICS TS for z/OS: CICS Users Handbook

0197 0198 0200 0201 0202 0203 0204 0205 0206 0207 0209 0210 0211 0213 0214 0220 0221 0222 0223 0224

DFHXG6442 DFHXG6443 DFHXA6540 DFHXA6541 DFHXG6444 DFHXG6430 DFHXA6530 DFHXG6439 DFHXG6415 DFHXA6523 DFHXG6427 DFHXA6528 DFH6529 DFHXG6524 DFHXA6580 DFHXO6700 DFHXO6704 DFHXO6702 DFHXO6703 DFHXO6720

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

Chapter 11. DFH messages

413

DFHXO6704 DFHXO6720 DFH5100 DFH5148 DFH5175 DFH5180 DFH5184 DFH5263 DFH5721 DFH5722 DFH5723 DFH5754 DFH6529

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

414

CICS TS for z/OS: CICS Users Handbook

Chapter 12. Transaction abend codes


When abnormal conditions occur, CICS can send a message to the CSMT transient data destination containing the transaction ID, the program name and the abend code. Here is an example:
DFHAC2236 date time applid Transaction tranid abend primary abcode in program program name term termid backout successful { batchid = }batchid. message

Alternatively, the application can intercept abends by including an active EXEC CICS HANDLE ABEND command. The actual abend code can be determined by issuing the EXEC CICS ASSIGN command with the ABCODE option. The transaction identification code tranid usually consists of the 4 characters defined to CICS. However, when a transaction is initiated by using a light pen, an operator identification (OPID) card reader, or 3270 PA or PF keys (specified in the TASKREQ= operand), CICS creates an internal transaction identification in the form of a 1-byte 3270 attention identification (AID) code followed by 3 bytes of X'FF'. The code that may actually appear in the message in place of the internally-created transaction identification will be *xx*, where xx is the character translation of the 3270 AID code. To prevent ambiguity, the user should avoid using these codes as transaction identifiers. The keys, the light pen (LPA), and OPID, and their corresponding printed AID codes are given in the following list:
PF1 PF2 PF3 PF4 PF5 PF6 PF7 PF8 PF9 PF10 PF11 PF12 *F1* *F2* *F3* *F4* *F5* *F6* *F7* *F8* *F9* *7A* *7B* *7C* PF13 PF14 PF15 PF16 PF17 PF18 PF19 PF20 PF21 PF22 PF23 PF24 *C1* *C2* *C3* *C4* *C5* *C6* *C7* *C8* *C9* *4A* *4B* *4C* LPA OPID PA1 PA2 PA3 *7E* *E6* *6C* *6E* *6B*

An abend code indicates the cause of an error that may have been originated by CICS or by a user program. For most of the abend codes described, a CICS transaction dump is provided at abnormal termination. All CICS transaction abend codes abcode are 4-character alphanumeric codes of the form Axxy, where: Aack M is the IBM-assigned designation of a CICS transaction abend. xx y is the 2-character code assigned by CICS to identify the module that detected an error. is the 1-character alphanumeric code assigned by CICS.

Copyright IBM Corp. 1989, 2002

415

Format of information
For each transaction abend code, the following information is given: v An explanation of events leading to or following the message. v The action that has been or will be taken by CICS (system action). v The action recommended for the user (console or terminal operator). v The module or modules that can determine that the message should be sent (not necessarily the module or modules that can issue the macro to write the message.)

416

CICS TS for z/OS: CICS Users Handbook

Chapter 13. Transaction abend codes


For guidance about interpreting the transaction abend codes summarized below, see the CICS Messages and Codes manual.
Abend AACA AALM AALN AALO AALP AALQ AALR AALS AALT AALU AALV AAL1 AAL2 AAL3 AAL4 AAL6 AAL7 AAMA AAMC AAMD AAMF AAMH AAMI AAMJ AAMK AAMN AAMO AAMP AAMQ AAMS AAMT AAMZ AAM1 AAM2 AAOA AAOB AAOC AAOD AAOE AAOF AAOG AAOH AAOI AAOJ AAOK AAOL Module DFHTFP, DFHACP DFHAMLM DFHAMTD DFHAMD2 DFHAMPG DFHAMBA DFHAMBA DFHAMBA DFHAMOP DFHAMSO DFHAMEJ DFHALP DFHALP DFHALP DFHALP DFHALP DFHALP DFHAMP DFHAMP DFHAMP DFHAMP DFHAMP DFHAMP DFHAMP DFHAMP DFHAMP DFHAMP DFHAMP DFHAMP DFHAMP DFHAMP DFHAMP DFHAMP DFHAMP DFHCPI DFHCPI DFHCPARH DFHCPCBI DFHCPCBA DFHCPCBS DFHCPCBA DFHCPCOJ DFHCPCRI, DFHCPCRW DFHCPIC DFHCPIC DFHCPCLR Explanation Invalid error code Error has occurred on call to Log Manager (LM) domain Error has occurred on call to the TD manager Error has occurred on call to the CICS/DB2 table manager DFHD2TM Error has occurred on call to the Program Manager Error has occurred on call to the Business Application Manager Error has occurred on call to the Temporary Storage Manager Error has occurred on call to the Global Enqueue Manager Error has occurred on call to the Internet Inter-Orb Protocol Manager Error has occurred on call to the Sockets Domain Manager Error has occurred on call to the Enterprise Java Domain DFHALP was processing a request that deadlocked Unexpected response from suspend or resume allocated task Task purged before GETMAIN completed Error occurred on call to storage manager (SM) domain Error occurred on call to SIGNOFF_TERMINAL_USER Error occurred on call to schedule a remote terminal delete Internal logic error in DFHAMP Task purged before GETMAIN completed Unexpected return code from DFHDMP, internal logic error Unexpected return code from KE domain, internal logic error Unexpected return code from DFHFCMT, internal logic error Unexpected return code from DFHFCRL, internal logic error Irrecoverable error from DFHFCFS while installing a file 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

Copyright IBM Corp. 1989, 2002

417

Abend AAOM AAON AAOO AAOP AAOQ AAOR AAOS AAOT AAOU AAOV AAOW AAOX AAOY AAOZ AAO2 AAO3 AAO4 AAO5

Module DFHCPCLR, DFHCPSRH DFHCPCLR, DFHCPCLC DFHCPARH DFHCPCFS DFHCPCFS DFHCPIC DFHCPIC DFHCPCBI DFHCPCBI DFHCPCFS DFHCPCLC DFHCPIC DFHCPCRB DFHCPCRB DFHCPCBA DFHCPI DFHCPCLR DFHCPCBA, DFHCPCBI, DFHCPCBS DFHCPSRH DFHCPSRH DFHCPCLR DFHBASP DFHBASP DFHEIBAM DFHEIBAM DFHMCP, DFHMCPE, DFHM32, DFHPBP, DFHRLR DFHMCP, DFHMCPE, DFHM32, DFHPBP, DFHRLR DFHPBP, DFHMCP DFHPBP, DFHMCP DFHMCX DFHMCP DFHTPP, DFHTPR DFHTPP, DFHTPR DFHPBP DFHMCP, DFHTPQ DFHMCP, DFHMCX, DFHMCY

Explanation 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 CPI Communications return code has no entry in state table CPI Communications detected invalid value in conversation control block CPI Communications finds unexpected RESET for conversation state CPI Communications chain error in conversation control blocks CPI Communications error processing initialize conversation request CPI Communications internal state table corrupted Internal logic error in DFHCPCLC CPI Communications has detected bad syncpoint return code Invalid LL field while CPI Communications receives mapped conversation Invalid ID field while CPI Communications receives mapped conversation Unexpected response from DFHLUC to CPI Communications Call to CPI Communications without initialization Logic error detected by DFHZARL Task purged before GETMAIN completed

AAO7 AAO8 AAO9 ABAC ABAD ABAE ABAF ABLA

Invalid DFHLUC parameter list passed to CPI Communications Invalid Conversation Control Block (CPC) passed to CPI Communications Task purge detected EXEC CICS RETURN issued for activity executed with RUN command. EXEC CICS RETURN ENDACTIVITY issued for activity executedwith RUN command. EXEC CICS RETURN issued for activity executed with LINK command. EXEC CICS RETURN ENDACTIVITY issued for activity executedwith LINK command. Task purged before GETMAIN request to SM domain completed

ABLB

Error on call to SM domain

ABMA ABMB

TIOA = 0 or < (storage accounting length - 12) Cursor position larger than current screen size

ABMC ABMD ABME ABMF ABMG ABMI

CMSG tran attempt to send to greater number of terminals than possible Unexpected return code from send DFHTPR or DFHTPP DFHTPR or DFHTPP detected invalid datastream during BMS request Send length too large BMS service not present Not input map

418

CICS TS for z/OS: CICS Users Handbook

Abend ABML ABMM ABMO

Module DFHRLR DFHPBP DFHMCP, DFHMCX, DFHMCY DFHQRY DFHTPR DFHMCP, DFHEMS DFHRLR DFHPBP DFHMCP, DFHMCX, DFHMCY DFHMCP, DFHMCX, DFHMCY DFHRLR DFHMCP DFHMCP DFHMCP, DFHTPP DFHMCP, DFHTPR DFHMCP DFHPBP DFHPBP DFHPBP DFHTPS DFHTPS DFHTPS DFHTPS DFHTPS DFHTPS DFHTPS DFHTPS DFHTPS DFHTPS DFHBRMS, DFHBRTC DFHBRMS, DFHBRTC DFHBRMS, DFHBRTC DFHBRMS, DFHBRTC DFHBRXM DFHBRXM DFHBRXM DFHBRXM DFHBRXM DFHBRIC, DFHBRMS, DFHBRSP, DFHBRTC

Explanation Terminal control locate routine received invalid data Invalid map specified Not output map

ABMQ ABMR ABMU ABMV ABMX ABMZ

Task not terminal-oriented or terminal not defined to CICS correctly CPSG initiated but task not terminal-oriented Address not within region boundaries Invalid route list entry Invalid set attribute order in text TIOA address in TCTTEDA is zero

ABM0

Map could not be located

ABM1 ABM2 ABM3 ABM4 ABM5 ABM6 ABM7 ABM8 ABM9 ABNA ABNB ABNC ABNE ABNF ABNG ABNH ABNI ABNJ ABNK ABRC ABRD ABRE ABRF ABRG ABRH ABRI ABRJ ABRK ABRN

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 No route list supplied Invalid TCTTE type for principal facility of the task Access temporary storage queue failed Error response from BMS ROUTE or STORE request Transaction not in send mode when sent to remote system Attach received from remote system without data Ship data to remote system failed No profile for LU6.2 transaction routing request Task purged before GETMAIN complete Error on call to storage manager domain Bridge exit not defined and could not be autoinstalled Bridge exit is disabled Bridge exit could not be loaded Bridge exit is defined as remote An invalid bridge facility token was specified The bridge facility token specified is in use by another transaction, or has been discarded There are no free bridge facility tokens available An invalid FACILITYLIKE value was specified The bridge exit returned an invalid brxa_resp value The USERID check failed following call to the bridge exit

Chapter 13. Transaction abend codes

419

Abend ABRQ ABRR ABRS ABRY ABRZ

Module DFHBRMS, DFHBRTC DFHBRXM DFHBRXM DFHBRMS, DFHBRTC DFHBRIC, DFHBRMS, DFHBRSP, DFHBRTC, DFHXMBR DFHEMS DFHTBS DFH0CBRF DFH0CBRE DFH0CBRE DFH0CBAE, DFH0CBRE DFH0CBAE, DFH0CBRE, DFH0CBAI DFH0CBAE, DFH0CBRE DFH0CBRF DFH0CBAE, DFH0CBRE DFH0CBAE, DFH0CBRE DFH0CBAE, DFH0CBRE DFH0CBAE, DFH0CBRE, DFH0CBRF DFH0CBRF DFH0CBRF DFH0CBRF DFH0CBRF DFH0CBRE DFH0CBAE, DFH0CBRE, DFH0CBRF DFH0CBAE, DFH0CBRE, DFH0CBRF DFH0CBAE, DFH0CBRE, DFH0CBRF DFH0CBAE, DFH0CBRE, DFH0CBRF DFH0CBAE, DFH0CBRE, DFH0CBRF DFH0CBRF DFH0CBRF DFH0CBRF

Explanation The bridge exit issued an abend The user transactions profile could not be found CICS was unable to obtain storage to create bridge facility CICS returned an unexpected error running the bridge exit The bridge exit returned invalid data in the BRXA

ABR3 ABSA ABXA ABXC ABXD ABXE ABXF

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 Error when SYNCPOINT ROLLBACK request issued by bridge exit No data passed on BRDATA parameter of START command Error detected by bridge exit inputting next message

ABXG ABXH ABXI ABXJ ABXK ABXM

Error detected by bridge exit outputting next message No data available in message - transaction is non conversational Message received by bridge exit exceeds maximum message size Bridge exit detected error in MQCIH passed by client application Bridge exit detected error in data passed on BRDATA parameter Bridge exit called with unsupported function or command

ABXN ABXO ABXP ABXQ ABXS ABX1

Bridge Bridge Bridge Bridge Bridge Bridge

exit exit exit exit exit exit

detected input messsage was truncated detected error in BRMQ vector passed by client application detected error in BRMQ vector header passed could not find ADSD vector as part of BRMQ-RM vector detected error trying to open queue for input/output called with invalid BRXA-HEADER - storage overwrite

ABX2

Bridge exit called with invalid BRXA-TRANSACTION-AREA - storage overwrite

ABX3

Bridge exit called with unsupported BRXA-COMMAND-AREA - storage overwrite

ABX5

Bridge exit called without a user-area - error in bridge exit

ABX6

Bridge exit called with invalid user-area - storage overwrite or error in bridge exit

ABX7 ABX8 ABX9

TC command passed to bridge exit exceeded maximum message size BMS BRMQ vector does not contain mapset requested Next BMS BRMQ vector does not contain mapname requested

420

CICS TS for z/OS: CICS Users Handbook

Abend ACAA ACAD ACAI ACAJ ACAM ACCx ACFA ACFB ACFC ACFD ACFE ACHA ACHB ACHC ACHD ACHE ACHF ACHG ACHH ACHI ACHJ ACHK ACHL ACHM ACHN ACHO ACHP ACHR ACHS ACL0 ACL1 ACL2 ACL3 ACL4 ACL5 ACL6 ACL7 ACL8 ACL9 ACLA ACLB ACLC ACLD ACLE ACLF ACLG ACLH ACNA ACNB

Module DFHCAP DFHCAP DFHCAP DFHCAP DFHECBAM DFHFCDL DFHEIFC DFHEIFC DFHFCDL DFHFCDL DFHCHS DFHCHS DFHCHS DFHCHS DFHCHS DFHCHS DFHCHS DFHCHS DFHCHS DFHCHS DFHCHS DFHCHS DFHCHS DFHCHS DFHCHS DFHCHS DFHCHS DFHCHS ICCGLBIC ICCGLBIC ICCRESEC ICCRESIC ICCGLIBC ICCBASEC ICCBASEC ICCGLBIC ICCGLBIC ICCRESIC ICCGLIBC ICCGLIBC ICCGLIBC ICCGLIBC ICCGLIBC ICCGLIBC ICCGLIBC ICCBASEC DFHCCNV DFHCCNV

Explanation Parameterized resource definition contains invalid resource type code Parameterized resource definition contains invalid resource type code Invalid function code for domain call to DFHCAP Preallocated dynamic storage area too small Internal Error in CBAM transaction C/370 errors. See the C/370 Users 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 programmers 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 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

Chapter 13. Transaction abend codes

421

Abend ACN1 ACN2 ACN3 ACN4 ACN5 ACN6 ACN7 ACN8 ACN9 ACP1 ACP2 ACQA ACQB ACQC ACRA ACRB ACRC ACRD ACRE ACRF ACRG ACRH ACRI ACRJ ACRK ACRL ACRM ACRN ACRO ACRP ACSA ACSB ACSC ACSD ACSE ACSF ACSG ACSH ACSI ACSJ # ACSK ACSL ACSM ACSN ACTA ACTB ACTC ACTD ACTE ACTF ACTG

Module DFHCCNV DFHCCNV DFHCCNV DFHCCNV DFHCCNV DFHCCNV DFHCCNV DFHCCNV DFHCCNV DFHCPY DFHCPY DFHCLS5 DFHCLS5 DFHCLS5 DFHAPRT DFHAPRT DFHAPRT DFHAPRT DFHAPRT DFHAPRT DFHAPRT DFHAPRT DFHAPRT, DFHEPC DFHAPRT, DFHEPC DFHAPRT DFHAPRT DFHAPRT DFHAPRT DFHCRQ DFHAPRT DFHCRS DFHCRS DFHCRS DFHCRS DFHCRS DFHCRS DFHCRS DFHCRS DFHCRS DFHCRS DFHZGIN DFHCRS DFHCRS DFHCRS DFHZTSP DFHZTSP DFHZTSP DFHZTSP DFHZTSP DFHZTSP DFHZTSP

Explanation 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 Relay program invoked by transaction not defined as remote Invalid response from DFHZCX System entry not found Link is out of service Dynamic routing program incorrectly initiated No matching entry in AID chain for ATI initiated remote transaction Profile could not be found Dynamic transaction routing program could not be linked Dynamic transaction routing program has abended Relay program invoked with no address for principal facility The task does not own the facility Dynamic routing program INITIAL_LINK failure Security check failure in dynamic routing program 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 Task purged or timed out waiting for a response from VTAM 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

422

CICS TS for z/OS: CICS Users Handbook

Abend ACTH ACTI ACTJ ACTK ACTL ACUA ACUB ACUC ACUD ACUE ACUF ACUG ACUH ACUI ACUJ ACUK ACUL ACUM ACUO ACUP ACUQ ACUR ACUS ACUT ACUV ACUW ACUX ACUY ACUZ ACU0 ACU1 ACU2 ACU3 ACU4 ACU5 ACU6 ACU7 ACU8 ACU9 ACVA ACVB ACVC ACVD ACVE ACVF ACVG ACVH ACVK ACVL ACVM ACVN ACVO ACVP ACVQ

Module DFHZISP DFHCRT DFHCRT DFHZISP DFHZISP DFHZXRL DFHZXRL DFHZXRL DFHZXRL DFHZXRL DFHZXRL DFHZXRL DFHZXRL DFHZXRL DFHZXRL DFHZXRL DFHZXRL DFHZXRL DFHZXRL DFHZXRL DFHZXRL DFHZXRL DFHZXRL DFHZXRL DFHZXRL DFHZXRL DFHZXRL DFHZXRL DFHZXRL DFHZXRL DFHZXRL DFHZXRL DFHZXRL DFHZXRL DFHZXRL DFHZXRL DFHZXRL DFHZXRL DFHZXRL DFHZXRT DFHZXRT DFHZXRT DFHZXRT DFHZXRT DFHZXRT DFHZXRT DFHZXRT DFHZXRT DFHZXRT DFHZXRT DFHZXRT DFHZXRT DFHZXRT DFHZXRT

Explanation Privileged allocate issued against a remote LU6.2 system TCTTE for session not owned by task 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 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
Chapter 13. Transaction abend codes

423

Abend ACVR ACWA ACXA ADCA ADCB ADCC ADCD ADCE ADCI ADCJ ADCP ADCQ ADCR ADCS ADCT ADCV ADDA

Module DFHZXRT DFHCWTO DFHCXCU DFHDLIDP DFHDLIDP DFHDLIDP DFHDLIDP DFHDLIDP DFHDLIDP DFHDLIDP DFHDLIDP DFHDLIDP DFHDLIDP DFHDBAT DFHDBCT DFHDLIDP DFHDBME, DFHDLI, DFHDLIDP DFHDBCON, DFHDBDSC DFHDBCON, DFHDBDI DFHDBCT DFHDBCON DFHCLS3 DFHDIP DFHDLIRP DFHDLIRP DFHDLIRP DFHDLIRP DFHDBCR DFHDBCR DFHDBCR DFHEIP, DFHCPIR, DFHDLI DFHDXCU DFHDXCU DFHD2EX1 DFHD2EX1 DFHD2EX1 DFHD2EX1 DFHD2EX1 DFHD2EX1 DFHD2EX1 DFHD2EX1 DFHD2EX1 DFHD2EX1 DFHD2EX1

Explanation 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 Connection to DBCTL terminated and then re-established Error on call to SM domain

ADDB ADDC ADDI ADDJ ADEF ADIR ADLE ADLF ADLG ADLP ADMA ADMB ADMD ADPL

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 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 ADXB AD2A AD2B AD2C AD2D AD2E AD2F AD2G AD2H AD2I AD2J AD2K

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

424

CICS TS for z/OS: CICS Users Handbook

Abend AD2L AD2M AD2N AD2O AD2P AD2Q AD2R AD2S AD2T AD2U AD2V AD2W AD2X AD2Y AD2Z AD21 AD22 AD23 AD24 AD25 AD26 AD27 AD28 AD29 AD3A AD3B AD3D AD3G AD3I AD3M AD3P AD3Q AD3R AD3S AD3T AD3U AD3W

Module DFHD2EX1 DFHD2EX1 DFHD2EX1 DFHD2EX1 DFHD2EX1 DFHD2EX1 DFHD2EX1 DFHD2EX1 DFHD2EX1 DFHD2EX1 DFHD2EX1 DFHD2EX1 DFHD2EX1 DFHD2EX1 DFHD2EX1 DFHD2EX1 DFHD2EDF DFHD2EX2 DFHD2EX2 DFHD2CC DFHD2CC DFHD2EX1 DFHD2EX1 DFHD2EDF DFHD2STR DFHD2STR DFHD2CM1 DFHD2CM1 DFHD2CM1 DFHD2CM1 DFHD2CM1 DFHD2CM1 DFHD2STR DFHD2CM1 DFHD2EX1 DFHD2EX1 DFHD2STR

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

Chapter 13. Transaction abend codes

425

Abend AD3X AD3Z AEC1

Module DFHD2CM1 DFHD2EX1 DFHECIP, DFHECSP, DFHEMTP, DFHESTP, DFHEOTP, DFHEDAP DFHECIP, DFHECSP, DFHEMTP, DFHESTP, DFHEOTP, DFHEDAP DFHAPLI DFHAPLI DFHAPLI DFHAPLI DFHAPLI DFHAPLI DFHAPLI DFHEDFX DFHEDFX DFHEDFX DFHEDFX DFHEDFX DFHEDFX DFHEDFX DFHEDFX DFHEDFP, DFHEDFBR DFHEDFX DFHEDFX DFHEDFP DFHEDFD DFHEDFU DFHEDFP DFHEDFX DFHEDFD DFHEIP DFHEIP DFHEIP DFHEIP DFHEIP DFHEIP DFHEIP DFHEIP DFHEIP DFHEIP DFHEIP DFHEIP DFHEIP DFHEIP DFHEIP

Explanation 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

AEC2

CECI, CEMT, or CEDA/B/C tried to use too small a screen

AEC3 AEC4 AEC5 AEC6 AEC7 AEC8 AEC9 AEDA AEDB AEDC AEDD AEDE AEDF AEDG AEDH AED1 AED2 AED3 AED4 AED5 AED6 AED7 AED8 AED9 AEIA AEID AEIE AEIG AEIH AEII AEIJ AEIK AEIL AEIM AEIN AEIO AEIP AEIQ AEIR

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

426

CICS TS for z/OS: CICS Users Handbook

Abend AEIS AEIT AEIU AEIV AEIW AEIZ AEI0 AEI1 AEI2 AEI3 AEI4 AEI8 AEI9 AELA AELB AEMA AEMB AEMP AEMQ AETA AETC AETF AETG AETH AETI AETJ AETK AETL AETM AETN AETO AETP AETQ AETR AETS AEXC AEXF AEXG AEXI AEXJ AEXK AEXL AEXU

Module DFHEIP DFHEIP DFHEIP DFHEIP DFHEIP DFHEIP DFHEIP DFHEIP DFHEIP DFHEIP DFHEIP DFHEIP DFHEIP DFHETL DFHEGL DFHUEM DFHUEM DFHUEM DFHUEM DFHERM DFHERM DFHERM DFHERM DFHERM DFHERM DFHERM DFHERM DFHERM DFHRMSY DFHRMSY DFHRMSY DFHRMSY DFHRMSY DFHRMSY DFHRMSY DFHEIP DFHEIP DFHEIP DFHEIP DFHEIP DFHEIP DFHEIP DFHEIDTI, DFHEIQDS, DFHEIQSA, DFHEIQSC, DFHEIQSM, DFHEIQSP DFHEIQST, DFHEIQSX DFHEIP DFHEIP DFHEIP

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

VOLIDERR condition not handled SUPPRESSED condition not handled TASKIDERR condition not handled

Chapter 13. Transaction abend codes

427

Abend AEXY AEXZ AEX0 AEX1 AEX2 AEX3 AEX4 AEX5 AEX6 AEX7 AEX8 AEX9 AEYA AEYB AEYC AEYD AEYE AEYG AEYH AEYJ AEYK AEYL AEYM AEYN AEYO AEYP AEYQ AEYR AEYT AEYU AEYV AEYX AEYY AEYZ AEY0 AEY1 AEY2 AEY3 AEY6 AEY7 AEY8 AEY9 AEZA AEZB AEZC AEZD AEZE AEZF AEZG AEZH AEZI

Module DFHxxx DFHxxx DFHEIP DFHEIP DFHEIP DFHEIP DFHEIP DFHEIP DFHEIP DFHEIP DFHEIP DFHEIP DFHEIP DFHEIP DFHEIP DFHSRP DFHEIP DFHEIP DFHEIP DFHEIP DFHEIP DFHEIP DFHEIP DFHEIP DFHEIP DFHEIP DFHEIP DFHEIP DFHEIP DFHEIP DFHEIP DFHEIP DFHEIP DFHEIP DFHEIP DFHEIP DFHEIP DFHEIP DFHUEM DFHEIP DFHEIP DFHEIP, DFHEEI DFHEIP DFHERM DFHAPLI DFHAPLI DFHEIP DFHEIP DFHEIP DFHEIP DFHEIP

Explanation Transaction purged before control was returned For module list, see CICS Messages and Codes Command failed due to serious failure in CICS component For module list, see CICS Messages and Codes TCIDERR condition not handled DSNNOTFOUND condition not handled LOADING condition not handled MODELIDERR condition not handled RECORDBUSY condition not handled PARTNERIDERR condition not handled PROFILEIDERR condition not handled NETNAMEIDERR condition not handled LOCKED condition not handled RECORDBUSY condition not handled INVERRTERM condition not handled INVMPSZ condition not handled IGREQID condition not handled Storage violation by CICS INVLDC condition not handled JIDERR condition not handled QIDERR condition not handled DSSTAT condition not handled SELNERR condition not handled FUNCERR condition not handled UNEXPIN condition not handled NOPASSBKRD condition not handled NOPASSBKWR condition not handled SEGIDERR condition not handled SYSIDERR condition not handled ISCINVREQ condition not handled ENVDEFERR condition not handled IGREQCD condition not handled SESSIONERR condition not handled USERIDERR condition not handled NOTALLOC condition not handled CBIDERR condition not handled INVEXITREQ condition not handled INVPARTNSET condition not handled INVPARTN condition not handled PARTNFAIL condition not handled Internal logic error in DFHUEM NOTAUTH condition not handled No DSA found on chain trying to free dynamic storage Invalid EXEC CICS command issued AMODE 24 program defined in transaction with TASKDATALOC=ANY 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

428

CICS TS for z/OS: CICS Users Handbook

Abend AEZJ AEZK AEZL AEZM AEZN AEZO AEZP AEZQ # AEZU AFCB AFCC AFCE AFCF AFCG AFCH AFCJ AFCK AFCL AFCM AFCN AFCO AFCR AFCS AFCT AFCU AFCV AFCW AFCY AFCZ AFC0 AFC2 AFC7 AFDA AFDB AFDC AFDD AFDE AFDF AFDG AFDH

Module DFHEIP DFHEIP DFHEIP DFHEIP DFHEIP DFHEIP DFHEIP DFHEIP DFHEIP DFHEIFC DFHEIFC, DFHDMPCA DFHEIFC DFHEIFC, DFHDMPCA DFHEIFC, DFHDMPCA DFHEIFC DFHFCU DFHDMPCA, DFHEIFC DFHDTLX DFHDTLX DFHDMPCA, DFHEIFC DFHDTLX DFHEIFC, DFHDMPCA DFHEIFC, DFHDMPCA DFHEIFC, DFHDMPCA DFHEIFC, DFHDMPCA DFHEIFC, DFHDMPCA DFHEIFC, DFHDMPCA DFHDMPCA, DFHEIFC DFHDMPCA, DFHEIFC DFHEIFC, DFHDMPCA DFHFCU DFHDMPCA DFHFCQT DFHFCQT DFHFCQT DFHFCQT DFHFCRD DFHFCOR DFHFCOR DFHEIFC, DFHDMPCA

Explanation 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 RESUNAVAIL condition not handled - see AEIA Unexpected response from DFHFCEI resource level security check Internal logical error on calling file control request module DFHFCFR A GETMAIN for FFLE storage failed File control deadlock between tasks File issued sequence of file control requests that would deadlock itself Request to disabled or closed table Task taking longer than DTIMEOUT interval specified for CSFU File update request issued against RLS mode data set during backup Response could not continue during loading of Shared Data Table by CSFL txn Data table load failed Journal record too large for journal buffer Transaction not internally attached by CICS on attempt to attach SMSVSAM server address space has failed SMSVSAM server address space was inactive SMSVSAM server has been recycled since an earlier request from same UOW Data set in lost locks state Request against file in RLS mode unable to acquire record lock FC request against file in RLS mode would cause deadlock Transaction purged during file request Irrecoverable error response from DFHFCFR to its caller Updating file after file control restart failed Disastrous error from DFHFCFS on open file request Disastrous error response from DFHFCFS to DFHDMPCA Attach of transaction failed - not internally attached by CICS Transaction not CFQS or CFQR CFQS failed due to serious error CFQR failed due to serious error Attach of transaction failed - not internally attached by CICS Attach of transaction failed - not internally attached by CICS CFOR failed due to serious error VSAM RLS unable to create new locks - coupling facility full

Chapter 13. Transaction abend codes

429

Abend AGMA AICA AICB AICC AICD AICE AICF AICG AICH AICJ AICK AICL AICN AICO AICQ AICR AICS AICT AIEA AIIA AIIT AII1 AII2 AII3 AII4 AII5 AINA AINB AINC AIND AINE AINF AING AINH AINI AINJ AINK AINL AINM AINN AINO AINP AINQ AINR AINS AISA AISB AISC AISD AISF

Module DFHGMM DFHSRP DFHICP DFHTAJP, DFHICP DFHICP DFHICP DFHICP DFHICP DFHICP, DFHEIIC DFHICP DFHEIIC DFHEIIC DFHICP DFHICXM DFHDFST DFHCRR DFHDFST DFHDFST DFHIEXM DFH***** DFH***** DFHIIRRS DFHIIRRS DFHIIRRS DFHIIRRS DFHIIRRS DFHINDT DFHINDT DFHINDT, DFHINDAP DFHINDT, DFHINDAP DFHINDT DFHINDT DFHINDT DFHINDT DFHINDT DFHINDT DFHINDT DFHINDT DFHINDT DFHINTRU DFHINTRU DFHINTRU DFHINTRU DFHINTRU DFHINTRU DFHMIRS DFHMIRS DFHMIRS DFHMIRS DFHMIRS

Explanation 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 DFHDFST is executing at a terminal which is not permitted Failure of DFHTC write request for IRC DFHDFST has encountered an error during Retrieve processing. DFHDFST has encountered an error during START processing. Unexpected EXCEPTION response on call to US domain Severe error in IIOP Request Processor IIOP Request Processor timed out Invalid start of IIOP Request Receiver transaction (CIRR) Exception response from IIOP Request Receiver program (DFHIIRR) IIOP Request Receiver task has been purged Disaster response from IIOP Request Receiver program (DFHIIRR) Incorrect PROTOCOL on TCPIPSERVICE for Request Receiver 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 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

430

CICS TS for z/OS: CICS Users Handbook

Abend AISG AISH AISI AISJ AISK AISL

Module DFHMIRS DFHCRNP DFHISP DFHCRNP DFHISP DFHLUP, DFHCLS3, DFHCLS4, DFHZLS1 DFHCRNP DFHCRNP DFHMIRS DFHMIRS DFHCRR DFHZARM DFHCRNP DFHMIRS DFHMIRS DFHCRSP DFHCRSP DFHLUP DFHMXP DFHCRSP DFHCRNP DFHCRNP DFHCRNP DFHCRNP DFHMIRS DFHMIRS DFHMIRS DFHMIRS DFHCRNP DFHISP DFHMXP DFHMIRS DFHMIRS DFHMIRS DFHMIRS DFHMIRS DFJCICS DFHJCP DFHJCP DFHJCP DFHJCP DFHJCP DFHAPLH DFHAPLH DFHAPLH DFHAPLH DFHAPLH DFHAPLH DFHAPLH DFHAPLH

Explanation Mirror transaction could not send reply Incorrect invocation of CSNC Invalid function shipping request from DFHEIP to DFHISP CSNC abended because LINK to DFHCRR failed Mirror transaction abended LU services manager transaction started directly from user terminal

AISN AISO AISP AISQ AISR AISS AIST AISU AISV AISW AISX AISY AISZ AIS1 AIS2 AIS3 AIS4 AIS5 AIS6 AIS7 AIS8 AIS9 AITA # AITB AITC AITD AITE AITF AITG AJA0 AJCD AJCE AJCS AJCT AJCU AJH0 AJH1 AJH2 AJH3 AJH4 AJH5 AJH8 AJH9

CSNC failed to acquire SUSPEND TOKEN CSNC failed to suspend itself Mirror transaction invoked with invalid principal facility 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 Purge response from log manager or recovery manager CEEPIPI address not in CSZCEEPI, or DFHAPPIS initialization failed. Hotpooling cannot be used CEEPIPI init call failed Unable to load HPJDLL. Hotpooling cannot be used Required functions not in HPJDLL. Hotpooling cannot be used. JNI_CreateJavaVM call to HPJDLL failed HNI_ObtainEnvironment call to HPJDLL failed LoadExe call to HPJDLL failed. There was an unhandled Java exception on return from the main class

Chapter 13. Transaction abend codes

431

Abend AJHA AJHB AJHC AJHD AJHE AJHF AJMA AJMB AJMC AJM1 AJM2 AJM3 AJM4 AJM5 AJM6 AJM7 AJM8 AJM9 AJ01 AJ02 AJ03 AJ04 AJ05 AJ07 AJ09 AJ10 AJ11 AJ12 AJ99 AKCB AKCC AKCE AKCF AKCR AKCS AKCT AKCV AKC0 AKC1 AKC2 AKC3

Module DFHAPLH DFHAPLH DFHAPLH DFHAPLH DFHAPLH DFHAPLH DFHCJVM DFHAPLJ DFHAPLJ DFHCJVM DFHCJVM DFHCJVM DFHCJVM DFHCJVM DFHCJVM DFHCJVM DFHAPLJ DFHCJVM DFJCICS DFJCICS DFJCICS DFJCICS DFJCICS DFJCICS DFJCICS DFJCICS DFJCICS DFJCICS DFJCICS DFHKCRP DFHXMAT, DFHXMCL DFHKCQ DFHKCQ DFHXCP DFHXCP DFHXCP DFHALP DFHAPATT DFHXCP DFHXCP DFHXCP, DFHXMAT, DFHXMCL, DFHXMIQ, DFHXMTA DFHXCP DFHXCP DFHXCP DFHKESTX DFHKESTX DFHKESTX, DFHKERRU

Explanation CEEPIPI call to DFHAPH8S failed CEEPIPI call to DFHAPH8L failed CEEPIPI call to DFHAPH8C failed The transaction was purged during a request to PG, SM, XM or TD CHANGE_MODE back to H8 failed during return from CICS to a PIPI services function CEEPIPI term failed Change directory to CICS_HOME failed Call to JVM program disallowed due to previous JVM terminationerrors CICS JVM interface failed to call user replaceable module DFHJVMAT 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. Main method of java 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 caught by Wrapper Wrapper unable to invoke the users main method Wrapper unable to invoke the users main method Wrapper unable to load DB2 JDBC classes Wrapper unable to find static method in DB2 JDBC class Wrapper unable to invoke static method in DB2 JDBC class Wrapper detected AbendException and issued setAbend abend code extracted from AbendException is too long Transaction manager restart task could not complete Purge threshold on TRANCLASS reached Write to system log failed Write to catalog failed Transaction manager received an invalid request code Deadlock time-out has occurred Terminal read-time-out has occurred Unexpected return code on resume of suspended task Attempt to run CSSY as user transaction DFHKC WAIT when ECB already marked as waiting Unexpected response from DS domain call Task has been purged

AKC6 AKC8 AKC9 AKEA AKEB AKEC

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

432

CICS TS for z/OS: CICS Users Handbook

Abend AKED AKEF AKEG AKEH AKEI AKEZ AKSE ALGA

Module DFHKEEDA DFHKERKE DFHKESGM DFHKESTX DFHKESTX DFHKETA DFH99KC DFHLGGL, DFHLGJN, DFHLGLD, DFHLGST DFHLGGL, DFHLGJN, DFHLGLD, DFHLGST DFHLGGL, DFHLGJN, DFHLGLD, DFHLGST DFHLGCM, DFHLGGL, DFHLGJN, DFHLGLD, DFHLGST DFHLGJN DFHLGGL, DFHLGJN, DFHLGST DFHLGQC DFHAPLI DFHAPLI DFHAPLI DFHAPLI DFHAPLI DFHAPLI DFHAPLI DFHMIRS DFHCMP DFHCMP DFHCMP DFHMSP DFHMSP DFHMSP DFHMSP DFHNQED, DFHNQIB, DFHNQNQ, DFHNQST DFHNQED, DFHNQIB, DFHNQNQ, DFHNQST DFHNQED DFHNQED DFHNQRN DFHOTR

Explanation Deferred abend request in KE domain Error detected while processing KE domain call MVS GETMAIN for kernel stack storage failed Transaction purged while running outside control of CICS. Kernel domain detected runaway while transaction isoutside control of CICS. Failure of user attach - insufficient kernel tasks No code for keyword Error obtaining lock within log manager domain

ALGB

Error releasing lock within log manager domain

ALGC

Disaster response detected processing building block code used by log manager domain

ALGD

Disaster response detected processing building block storage interface code used by log manager domain

ALGE ALGF

Unexpected error while log manager attempted to find jounal model definition Unexpected error when log manager attempted enqueue/dequeue operation

ALGG ALIA ALIB ALIC ALID ALIE ALIF ALIG AMI1 AMNA AMNB AMNZ AMSA AMSB AMSC AMSD ANQA

Transaction CSQC issued from a terminal Insufficient storage to satisfy GETMAIN request Insufficient storage to satisfy GETMAIN request 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 domaininvalid address in DATA1 Exception response from MN domaininvalid data in DATA2 Unexpected error response from MN domain SBA not followed by two 1-byte address fields Internal logic error in DFHMSP Task purged before GETMAIN to SM domain completed Error on call to SM domain Error occurred obtaining lock within enqueue domain

ANQB

Error occurred releasing lock within enqueue domain

ANQC ANQD ANQE AOTA

Error occurred obtaining sysplex enqueue Error occurred obtaining sysplex enqueue EXEC ENQ issued and enqmodel disabled or in waiting state OT resync transaction started incorrectly
Chapter 13. Transaction abend codes

433

Abend AOTB APCF APCG APCH APCI APCJ APCK APCL APCN APCO APCS APCT APCW APCY APCZ APC0 APC1 APC2 APC3 APC4 APC5 APC6 APC7 APC8 APC9 APLx APP1 APP2 APP3 APR1 APSJ APST APSU APSV APSW APSX APSY APSZ APTI APTJ APUA APUB APUC APUD APUE APUF APUG APUH APUI APUJ APUK

Module DFHOTR, DFHPG0002 DFHAPLI DFHxxx DFHAPLI DFHAPLI DFHAPLI DFHAPLI DFHAPLI DFHxxx DFHAPXM DFHAPLI DFHxxx DFHAPLI DFHAPLI DFHAPLI DFHPCP, DFHMCY DFHAPLI DFHAPLI DFHAPLI DFHPCPC2 DFHPCPC2 DFHPCPC2 DFHPCPC2 DFHPCPC2 DFHPCPC2 DFHP3270 DFHP3270 DFHP3270 DFHPRK DFHPSIP DFHEPS DFHPSPST DFHPSPST DFHPSPST DFHPSPST DFHPSPST DFHPSPST DFHPSPST DFHPSPST DFHPUP DFHPUP DFHPUP DFHPUP DFHPUP DFHPUP DFHPUP DFHPUP DFHPUP DFHPUP DFHPUP

Explanation Unexpected error in OT domain resynchronization 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 Macro request from PL/I or COBOL application Program not reentrant and cannot be loaded into read-only storage Serious error on call to program manager domain Request for TGT exceeding 64KB in size Illegal branch following abend condition No Language Environment/370 support present for program Loader domain define request failed for program ILBOCOM Loader domain load request failed for program ILBOCOM An internal error has occurred An MVS IDENTIFY call for entry point ILBOCOM0 failed An MVS LOAD of ILBOCOM0 has failed An MVS LOAD of ILBOCOM has failed PL/I abend code (see OS/VS PL/I Optimizing Compiler: Programmers 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) 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

434

CICS TS for z/OS: CICS Users Handbook

Abend APUL APUM APUN APUO APUP APUQ APUR APUS APUT APUZ APXA ARCB ARHA ARHB ARHC ARM0 ARPA ARPF ARPG ARPH ARPI ARPJ ARPK ARPL ARPM ARPN ARPO ARPU ARPV ARPW ARPX ARPZ ARP2 ARP4 ARP5 ARP9 ARTA ARTB ARTC ARTD ARTE ARTF ARTG ARTH ARUA ARUB ARUC ARXA ARXB ARXC

Module DFHPUP DFHPUP DFHPUP DFHPUP DFHPUP DFHPUP DFHPUP DFHPUP DFHPUP DFHPUP DFHAPXM DFHRCEX DFHCPIR DFHCPIR DFHCPIR DFHRMXN3 DFHRTC DFHRPAS DFHRPAS DFHRPAS DFHRPAS DFHRPAS DFHRPAS DFHRPAS DFHRPAS DFHRPAS DFHRPAS DFHRPC01 DFHRPC0E DFHRPC0E DFHRPC01 DFHRPC0B DFHRPMS DFHRPMS DFHRPMS DFHRPC01 DFHRTE DFHRTE DFHRTE DFHRTE DFHRTE DFHRTE DFHRTE DFHRTE DFHXMRU DFHXMXM DFHXMRU DFHRXUW DFHRXUW DFHRXUW

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

Chapter 13. Transaction abend codes

435

Abend ARZE

Module DFHRZLN, DFHRZRM, DFHRZSO, DFHRZSO1, DFHRZTA, DFHRZXM DFHRZLN, DFHRZRM, DFHRZSO, DFHRZSO1, DFHRZTA, DFHRZXM DFHRZLN, DFHRZRM, DFHRZSO, DFHRZSO1, DFHRZTA, DFHRZXM DFHRZLN, DFHRZRM, DFHRZSO, DFHRZSO1, DFHRZTA, DFHRZXM DFHRZXM DFHRZIX, DFHRZCX DFHRZRM, DFHRZSO1 DFHSMSCP DFHSMSCP DFHSMSCP DFHSMSCP DFHCESD DFHSFP DFHSFP DFHSFP DFHSHDM DFHSHDM DFHSHRSP DFHSHRSP DFHSHXM DFHSHRM DFHSHXM DFHSII1 DFHSIPLT DFHSJCS DFHSJCS DFHSJCS DFHSJCS DFHSJIN DFHSJCS DFHSJCS DFHSJCS DFHSJCS DFHSJCS

Explanation Command failed due to a serious failure in a CICS component

ARZF

Command failed due to a serious failure in a CICS component

ARZI

Command failed due to a serious failure in a CICS component

ARZJ

Command failed due to a serious failure in a CICS component

ARZ2 ARZ3 ARZ4 ASCA ASCB ASCP ASCR ASDA ASFA ASFB ASFC ASHA ASHB ASHR ASHU ASH2 ASH3 ASH4 ASIA ASIB ASJC ASJD ASJE ASJF ASJG ASJH ASJI ASJ1 ASJ3 ASJ4

Resources required to service request unobtainable Resources required to service request unobtainable Resources required to service request unobtainable 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 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 Attempt to open jvmprofile failed Attempt to load DLL has failed Attempt to locate Wrapper class failed Attempt to change HFS working directory failed Attempt to fetch urm DFHJVMAT has failed Attempt to open WORK_DIR for output failed Attempt to open a jvm system properties file has failed A call to the Java Native Interface has failed. The JVM failed to find the main method of the CICS Wrapper class. The SJ domain failed to build an argument list to invoke the CICS Wraper class.

| | |

436

CICS TS for z/OS: CICS Users Handbook

Abend

Module DFHSJCS DFHSJCS DFHSNP DFHSNP DFHSNP DFHSNTU DFHSOL DFHSOL DFHSOL DFHSOL DFHAPAC DFHAPAC DFHSPP DFHEISP DFHAPAC DFHCR2U DFHCR2U DFHAPAC DFHAPAC DFHAPAC DFHAPAC DFHAPAC DFHAPAC DFHAPAC DFHAPAC DFHAPAC DFHAPAC DFHEISP DFHCRRSY DFHCRRSY DFHCRRSY DFHCRRSY DFHCRRSY DFHCRRSY DFHCRRSY DFHCRRSY DFHCRRSY DFHCRRSY DFHCRRSY DFHSRP DFHSRP DFHSRP DFHSRP DFHSR1 DFHZARQ DFHZARQ DFHZARQ DFHZDSP, DFHZERH DFHZARQ DFHZCRQ DFHZARQ

Explanation The Wrapper returned an exception when invoked by the CICS JVM. A call to the kernel to ensure that the CICS ESTAE was current has failed. 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 TCP/IP listener task CSOL encountered a lock error TCP/IP listener task CSOL encountered an unlock error TCP/IP listener task CSOL abended Task purged before request to RM domain completed successfully Error on call to RM domain Error on call to bridge syncpoint routine (DFHBRSP) User Syncpoint not allowed in OTS transaction 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 CLS2 transaction could not use transaction manager for input parameters The CLS2 transaction requested a warm exchange log names but did not receive a warm exchange log names reply 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

| |

ASJ5 ASJ6 ASNA ASNB ASNC ASND ASOA ASOB ASOC ASOL ASPA ASPB ASPC ASPD ASPF ASPI ASPJ ASPN ASPO ASPP ASPQ ASPR ASP1 ASP2 ASP3 ASP7 ASP8 ASP9 ASQA ASQB ASQC ASQD ASQE ASQG ASQH ASQI ASQK ASQL ASQM ASRA ASRB ASRD ASRE ASRK ATCA ATCB ATCC ATCD ATCE ATCF ATCG

Chapter 13. Transaction abend codes

437

Abend ATCH ATCI

Module DFHxxx DFHZSUP DFHMRXM DFH62XM DFHZATA DFHZATD DFHZATR DFHZARQ DFHETL, DFHTCPCM, DFHZARQ DFHZGXA DFHZSUP DFH62XM DFHTFXM DFHZARQ DFHZRAQ DFHZRAR DFHZARQ DFHZSUP DFHMRXM DFH62XM DFHZARQ DFHETL, DFHZARQ, DFHZISP DFHZSUP DFHMRXM DFH62XM DFHxxx DFHZARQ, DFHZSUP DFHMRXM DFH62XM DFHZSLS DFHTCRP DFHZSLS DFHZARQ DFHTCRP DFHETL DFHETL DFHZSUP DFHETL DFHZNCE DFHETD DFHTDB DFHTDRP DFHTDRP DFHTDB DFHTDB DFHTOUT1 DFHTOUT1 DFHTMP

Explanation Task purged before domain call completed successfully For module list,see CICS Messages and Codes Error occurred on call to DFHRTSU

ATCJ

Invalid autoinstall invocation

ATCK ATCL

Write issued with CCOMPL=NO without authority Error during automatic journaling or automatic logging

ATCM ATCN

Request to build a DCE security attach has failed Error during automatic journaling or automatic logging

ATCO ATCQ ATCR ATCS ATCT

Function unsupported by terminal or system Temporary storage error Temporary storage error Send data after request change direction received Build of surrogate TCTTE for remotely-owned terminal failed

ATCU ATCV

Send in receive mode Application attempted operation on logical unit which failed

ATCW

No installed profile definition for LU6.1 or APPC session

ATCX ATCY

Error on call to SM domain For module list,see CICS Messages and Codes Error processing inbound FMH

ATCZ ATC1 ATC2 ATC3 ATC4 ATC5 ATC6 ATC7 ATC8 ATC9 ATDC # ATDS ATDY ATDZ # ATD3 # ATD9 ATFE ATGE ATMA

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 Deadlock timeout has occurred Transient data initialization failed CICS function invoked by TD init failed Task has been purged Error call to NQ domain 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

438

CICS TS for z/OS: CICS Users Handbook

Abend ATMB ATNA ATNB ATNC ATND

Module DFHTMP DFHZNAC DFHZARQ DFHZARQ DFHZARQ, DFHZARL, DFHZSUP DFHZARL, DFHZARM, DFHZARQ, DFHZRAQ, DFHZSUP DFHCESC DFHCESC DFHCESC DFHCESC DFHCESC DFHCESC DFHCESC DFHCESC DFHCEGN DFHCEGN DFHCEGN DFHTPR DFHTPR DFHTPQ DFHTPQ DFHTPQ, DFHTPR DFHTPQ, DFHTPR DFHTRP DFHTSDQ DFHTSDQ DFHEITS, DFHICP, DFHTSP DFHEITS, DFHICP, DFHTSP DFHEITS, DFHTSP DFHEITS DFH99KO DFHUEM, DFHERM DFHUEH CAUCAFB1 CAUCAFF3, CAUCAFF6, CAUCAFB1 CAUCAFB1 CAUCAFB1 CAUCAFB2, CAUCAFF3 CAUCAFB1 CAUCAFB1

Explanation Error on call to SM domain Terminal operator entered transaction identification for NACP Terminal request failed TC request issued after abend ATCH Task termination postponed

ATNI

Task terminated by NEP (VTAM) or TEP (non-VTAM)

ATOA ATOB ATOC ATOD ATOE ATOF ATOG ATOH ATOT ATOU ATOV ATPA ATPB ATPC ATPD ATPE ATPF ATRA ATSA ATSB ATSC ATSD

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

| |

ATSP ATSQ ATUF AUEL AUEP AUXA AUXB

AUYA AUYC AUYE AUYF AUYG

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

Chapter 13. Transaction abend codes

439

Abend AUYH

Module CAUCAFF4, CAUCAFF5, CAUCAFB1 CAUCAFB2, CAUCAFF6 CAUCAFB2 CAUCAFF1, to CAUCAFF6, CAUCAFF7, CAUCAFB1, CAUCAFB2, CAUCAF41 CAUCAFF1, to CAUCAFF6, CAUCAFB1, CAUCAFB2 CAUCAFF1, CAUCAFF2 CAUCAFF1, CAUCAFF2 CAUCAFF1, to CAUCAFF6, CAUCAFB1 CAUCAFF3 CAUCAFF3, CAUCAFF6 CAUCAFF3 CAUCAFF3 CAUCAFF4 CAUCAFF4 CAUCAFF6 CAUCAFF3 CAUCAFF4, CAUCAFF5, CAUCAFB1 CAUCAFF4 CAUCAFF1 CAUCAFF1 CAUCAFF3, CAUCAFB2 CAUCAFF3, CAUCAFF6 CAUCAFF3 DFHWBXN DFHWBBLI DFHWBENV, DFHWBTL DFHWBBLI DFHWBA DFHWBA DFHWBA DFHWBA DFHWBA DFHWBA DFHWBA

Explanation The TAU Detector program found invalid address in Detector GWA

AUYI AUYJ AUZA

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

AUZB

Unexpected error when CAFF or CAFB issued a VSAM FC EXEC CICS command

AUZC AUZD AUZF

Invalid internal field holding TAU Detector state CICS APPLID in TAU file does not match APPLID of CICS system Unexpected error when CAFF or CAFB issued a Detector user exit

AUZH AUZI AUZJ AUZK AUZL AUZN AUZO AUZQ AUZR

Unexpected error when CAFF called CAUTABM to create MVS dataspace Unexpected error when CAFF called CAUTABM to create affinity table Unexpected Unexpected Unexpected Unexpected Unexpected Unexpected Unexpected error error error error error error error when when when when when when when CAFF CAFF CAFF CAFF CAFF CAFF CAFF called CAUTABM to add element to table attempted to initialize internal trace table attempted to release internal trace table called CAUTABM to destroy dataspace called CAUTABM to destroy table CAUCAFP to create MVS CPOOL storage or CAFB called CAUCAFP to access storage

AUZS AUZU AUZV AUZY AUZZ AUZ1 AWBA AWBB AWBC AWBE AWBF AWBH AWBI AWBJ AWBK AWBL AWBM

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 Web Interface alias detected error in EXEC CICS LINK for DFHWBBLI Web Interface alias detected an error from program DFHWBBLI

440

CICS TS for z/OS: CICS Users Handbook

Abend AWBO AWBQ AWBR AWBU AWBV AWBX AWBZ AWB2 AWB3 AWB4 AWB5 AWB7 AWB8 AWB9 AWC1 AWC2 AWC3 AWC4 AWC5 AWC6 AWC7 AWC8 AWKY AXFA AXFB AXFC AXFD AXFE AXFF AXFG AXFH AXFI AXFJ AXFL AXFM AXFO AXFP AXFQ AXFR AXFS AXFT AXFU AXFW AXFX AXFY AXF0 AXF1 AXF2 AXF3

Module DFHWBA DFHWBA1, DFHWBBLI DFHWBA1, DFHWBBLI DFHWBC01 DFHWBC04 DFHWBC01 DFHWBC0B DFHWBXN DFHWBXN DFHWBXN DFHWBM DFHWBENV DFHWBGB DFHWBC01 DFHWBLT DFHWBLT DFHWBLT DFHWBLT DFHWBLT DFHWBLT DFHWBXM DFHWBXM DFHWKP DFHXFP DFHXFP DFHXFP DFHXFP DFHXFP DFHXFP DFHXFP DFHXFP DFHXFP DFHXFP DFHXFP DFHXFP DFHXFP DFHXFP DFHXFP DFHXFP DFHXFP DFHXFP DFHXFP DFHXFP DFHXFP DFHXFP DFHXFP DFHXFP DFHXFP DFHXFP

Explanation Web Interface alias received non_HTTP request for HTTP service 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 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 Web attach processing DFHWBXM could not proceed with the attach for a Web alias transaction due to a security error Web attach processing DFHWBXM could not proceed with the attach for a Web alias transaction due to an unexpected error 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 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

Chapter 13. Transaction abend codes

441

Abend AXF4 AXF5 AXF8 AXMA AXMB AXMC AXMD

Module DFHXFX DFHXFX DFHXFX DFHxxx DFHxxx DFHXMAT, DFHXMXE DFHXMAB DFHXMAT DFHXMAT DFHXMTA DFHXSMN DFHXSMN DFHTCRP DFHXTP DFHXTP DFHXTP DFHXTP DFHXTP DFHXTP DFHXTP DFHXTP DFHXTP DFHXTP DFHXTP DFHXTP DFHXTP DFHETL DFHXTP DFHXTP DFHXTP DFHXTP DFHZARM DFHZCN1 DFHZCN1 DFHZCN1 DFHZCT1 DFHZCT1 DFHZCT1 DFHZCN1 DFHZCT1 DFHZARM DFHZARM DFHZARM DFHETL, DFHZARM DFHETL, DFHZARM DFHZARM DFHZARM DFHETL, DFHZARM

Explanation 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 Invalid userid assigned to transaction during transaction attach. 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 Wrong sync level for messageprotected 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 X088901xx received during APPC mapped processing Unsupported function management data DFHZARM invalid data length received Application data length to be received exceeds allowable limits Invalid request to DFHZARL Invalid TCTTE Unexpected sense code X0889xxxx received while processing APPC mapped data

| AXMU
AXMY AXMZ AXSA AXSC AXSD AXTA AXTB AXTC AXTD AXTE AXTF AXTG AXTH AXTI AXTJ AXTK AXTL AXTM AXTN AXTO AXTP AXTQ AXTR AZAB AZAD AZAE AZAF AZAG AZAH AZAI AZAJ AZAK AZCA AZCB AZCC AZCD AZCE AZCF AZCG AZCH

442

CICS TS for z/OS: CICS Users Handbook

Abend AZCI

Module DFHETL, DFHZARM, DFHZARQ DFHZARM DFHZARM DFHZARM DFHZARM DFHZARM DFHZCGRP DFHZSUP DFH62XM DFHZSUP DFHMRXM DFH62XM DFHZARL DFHZARQ DFHZCOVR DFHZCOVR DFHZCSTP DFHZIS2 DFHZIS2 DFHZIS2 DFHZIS2 DFHZARQ DFHZARQ DFHZARQ DFHZARQ DFHZARQ DFHZARQ DFHZARQ DFHZARQ DFHZIS2 DFHZIS1 DFHZIS2 DFHZARRC DFHZARR0 DFHZARR0 DFHZARR0 DFHZARRF DFHZARR DFHZARR DFHZARR1 DFHZARR0 DFHZARRF DFHZARRF DFHZARR DFHZARRF DFHZARER DFHZARER DFHZARRA DFHZARRA DFHZARRA DFHZARRA DFHZARRF

Explanation Invalid sync level

AZCJ AZCK AZCL AZCM AZCN AZCO AZCP AZCQ

System does not support APPC structured field with null data Internal logic error in error recovery for APPC mapped processing Sense code X088901xx 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 Logic error in ZCP Error on call to RM domain

AZCR AZCT AZCU AZCV AZCW AZIA AZIB AZIC AZID AZIE AZIF AZI1 AZI2 AZI3 AZI4 AZI5 AZI6 AZI7 AZI8 AZI9 AZRA AZRB AZRD AZRE AZRF AZRG AZRH AZRI AZRJ AZRK AZRL AZRM AZRN AZRO AZRP AZRQ AZRR AZRS AZRT AZRU

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

Chapter 13. Transaction abend codes

443

Abend AZRV AZRW AZRY AZRZ AZR2 AZR3 AZR4 AZR5 AZR6 AZS0 AZS1 AZS2 AZS3 AZS4 AZS5 AZS6 AZTA AZTB AZTC AZTF AZTG AZTH AZTI AZTL AZTM AZTN AZTO AZTP AZTQ AZTR AZTS AZTT AZTU AZTV AZTW AZTY AZTZ AZT1 AZT3 AZT6 AZT7 AZT8 AZT9 AZVA AZVB AZVC AZVD AZVE AZVF AZVG AZVH AZVI AZVJ

Module DFHZARR1 DFHZARRA DFHZARR DFHZARR DFHZARRA DFHZARRA DFHZARER DFHZARR1 DFHZARER DFHZSTAP DFHZSTAP DFHZSTAP DFHZSTAP DFHZSTAP DFHZSTAP DFHZSTAP DFHZTSP DFHZTSP DFHZTSP DFHZTSP DFHZTSP DFHZTSP DFHZTSP DFHZTSP DFHZTSP DFHZTSP DFHZTSP DFHZTSP DFHZTSP DFHZTSP DFHZTSP DFHZTSP DFHZTSP DFHZTSP DFHZTSP DFHZTSP DFHZTSP DFHZTSP DFHZTSP DFHZTSP DFHZTSP DFHZTSP DFHZTSP DFHZATS DFHZATS DFHZATS DFHZATS DFHZATS DFHZATS DFHZATS DFHZATS DFHZATS DFHZATS

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

444

CICS TS for z/OS: CICS Users Handbook

Abend AZVK AZVL AZVM AZVN AZVO AZVP AZVQ AZVR AZVS AZVU AZXA AZXB DHxx 0100

Module DFHZATS DFHZATS DFHZATMF DFHZATMF DFHZATMD DFHZATMD DFHZATS DFHZATS DFHZATS DFHZATS DFHZXCU DFHZXCU DFH***** DFHEAP DFHECP DFHEDP DFHEPP DFHEAP DFHECP DFHEDP DFHEPP DFHPD DFHPDX DFHPD DFHPDX DFHCSDUP DFHCSDUP DFHCSDUP DFHCSDUP DFHCSDUP DFHCSDUP DFHCSDUP DFHCSDUP DFHCSDUP DFHCSDUP DFHCSDUP DFHCSDUP DFHCSDUP DFHCSDUP DFHCSDUP DFHCSDUP DFHCSDUP DFHCSDUP DFHCSDUP DFHXCSTB DFHXCPRH DFHXCPRH DFHXCPRH DFHXCPRH DFHXCPRH DFHXCPRH DFHXCPRH DFHXCPRH DFHXCPRH DFHXCDMP DFHXCEIP

Explanation 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 Catch-up program finds unexpected error, reason code 5 Catch-up program finds unexpected error, reason code 4 EXEC DL/I error or invalid status code (xx) Translator error opening listing data set

0101

Translator program check

0211 0212 0300 0301 0302 0303 0304 0305 0307 0308 0309 0321 0322 0323 0325 0326 0327 0328 0330 0331 0332 0401 0402 0403 0404 0405 0406 0407 0408 0409 0410 0411 0412

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 DFHCSDUP CEE environment initialization failed DFHCSDUP EXTRACT command failed 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 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

Chapter 13. Transaction abend codes

445

Abend 0413 0414 0415 0501

Module DFHXCEIP DFHXCEIP DFHXCEIP DFHCALLA, DFHMSGIF, DFHTRCIF DFHAPLJ

Explanation Error in EXEC parameter list of EXCI EXEC API request Nonzero return code following MVS ESTAE issued by DFHXCEIP Error in EXCI initialization detected by DFHXCEIP JCICS request attempted on a pthread

0555

CICS JVM interface percolation abend to drive LanguageEnvironment recovery

446

CICS TS for z/OS: CICS Users Handbook

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


Abend codes with 1 through 9 as the first character are issued by VS COBOL II applications running on CICS. The last three digits of the abend code, xxx, correspond to the xxx in the associated VS COBOL II run-time message, IGZxxxI. VS COBOL II run-time messages are described in the VS COBOL II Application Program Debugging Guide, SC26-4049.

Copyright IBM Corp. 1989, 2002

447

448

CICS TS for z/OS: CICS Users Handbook

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 DFHZC2119 DFHZC2351 DFHZC2400 DFHZC2401 DFHZC2402 DFHZC2403 DFHZC2404 DFHZC2404 DFHZC2404 DFHZC2405 DFHZC2406 DFHZC2407 DFHZC2408 DFHZC2408 DFHZC2409 DFHZC2410 DFHZC2411 DFHZC2412 DFHZC2413 DFHZC2414 DFHZC2416 Action flags set Error code X5D XFB XFC X7A X79 XFD X71 X72 XFF XFE X6C X6D XE9 XDB XDE X6F XC1 XB1 XB4 X11 XE6 X14 X18 X10 X19 X15 X1A X1E XD0 XD1 XE0 XE1 XE2 X80 X13 Symbolic label TCZPRDTO TCZPSUNB TCZPSOPN TCZPSRAC TCZPSRAF TCZPSRC TCZPSLE TCZPSVF TCZPSPE TCZPSRF TCZPSAF TCZPSAR TCZSTIND TCZPIPL TCZPIPP TCZSDAS TCZSRCAT TCZRPLAC TCZRSNE TCZSRCBF TCZDMLG TCZLRCER TCZLRCNR TCZSRCTU TCZSRCTS TCZSRCPF TCZSRCVE TCZSRCV2 TCZTXCS TCZTXCU TCZDMSN TCZDMRA TCZDMCL TCZSRCSP TCZSRCVH

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 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 2 3 9 10 11 18 9 10 11 18 2 3 9 10 11 2 3 9 10 11 2 3 9 10 11 2 3 9 10 11 2 3 9 10 11 24 AOS 24 AOS

24 18 18 15 18

24 24 24 24

2 18 24

Copyright IBM Corp. 1989, 2002

449

VTAM
CICS message 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 DFHZC2446 DFHZC2447 DFHZC2448 DFHZC2449 DFHZC2450 DFHZC2451 DFHZC2452 DFHZC2453 DFHZC2454 DFHZC2455 DFHZC2456 DFHZC2457 DFHZC2458 DFHZC2459 DFHZC2463 DFHZC2467 DFHZC2468 DFHZC2469 DFHZC2469 DFHZC2470 DFHZC2471 Action flags set 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 Error code X1D X20 XBB X82 XB5 X60 X90 X74 X75 XB2 X94 XC5 X92 X91 X78 XCB X81 XE4 X43 X96 X97 X73 XA1 X98 XD7 XD6 XDC X59 XA3 X95 X84 X9A X65 XA7 X83 XCC XD5 XD4 XCD X93 X44 XD8 XDD X99 XD3 X88 X89 XD9 XF2 XDA XA8 Symbolic label TCZSRCVI TCZVTAMI TCZSEXUC TCZSSXUC TCZSAXUC TCZUNCMD TCZLGCER TCZSDSE5 TCZSESE1 TCZSDAUC TCZRACES TCZSRCNA TCZSDSE6 TCZRSTLE TCZSDRE2 TCZSRCTC TCZSSXNR TCZAIER TCZCPYNS TCZRVSZ1 TCZRVSZ3 TCZSDSE4 TCZRVSZ2 TCZACT01 TCZSXC1 TCZSXC2 TCZPXE1 TCZROCT TCZBKTSE TCZSDSE8 TCZSSXIB TCZDOMCF TCZINVRR TCZBOEB TCZSSXAR TCZSRCCI TCZCXE2 TCZCXRR TCZSRCCX TCZRACET TCZSRCDE TCZRNCH TCZPXE2 TCZSDSE7 TCZDMPD TCZLEXCI TCZLEXUS TCZYX43 TCZEXRVT TCZSXC3 TCZFMHLE

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 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 2 3 1 2 2 2 2 3 9 2 3 3 3 3 9 10 11 10 11 18 24 3 9 10 11 9 10 11 9 10 11 9 10 11 18 24 9 10 11 24

3 9 11 2 3 9 10 11 24 2 3 9 10 11 24 AOS 2 3 9 10 11 2 3 9 10 11 9 10 11 24 2 3 10 11 22 24 PRTTIOA

450

CICS TS for z/OS: CICS Users Handbook

VTAM
CICS message DFHZC2472 DFHZC2473 DFHZC2485 DFHZC2486 DFHZC2487 DFHZC2488 DFHZC2489 DFHZC2490 DFHZC2497 DFHZC2498 DFHZC3400 DFHZC3402 DFHZC3409 DFHZC3410 DFHZC3416 DFHZC3417 DFHZC3418 DFHZC3419 DFHZC3420 DFHZC3421 DFHZC3422 DFHZC3424 DFHZC3428 DFHZC3429 DFHZC3430 DFHZC3431 DFHZC3432 DFHZC3433 DFHZC3434 DFHZC3440 DFHZC3441 DFHZC3442 DFHZC3443 DFHZC3444 DFHZC3452 DFHZC3454 DFHZC3455 DFHZC3461 DFHZC3462 DFHZC3463 DFHZC3464 DFHZC3465 DFHZC3466 DFHZC3468 DFHZC3469 DFHZC3470 DFHZC3470 DFHZC3471 DFHZC3472 DFHZC3473 DFHZC3474 DFHZC3475 DFHZC3476 Action flags set 11 3 9 11 3 9 10 11 3 3 3 9 11 2 3 9 10 11 15 24 Error code XA9 XAA XE3 X9B X76 X77 X40 X41 X42 X4B X45 X46 X85 XBC XE8 X50 X51 X52 X53 X5A X5B X5C XEB XEC XED XEF XEA X58 X54 X55 X63 X67 X64 X6A X66 X5E X5F X48 X49 X4A X57 X9D X69 X70 XCE XAB X37 XCF X9E X4D XAC XAD XAE Symbolic label TCZRACRF TCZSDSE9 TCZCNCL TCZRACNL TCZLGNA TCZDMRY TCZINCPY TCZTOLRQ TCZUNPRT TCZICPUT TCZCHMX TCZOCIR TCZUNEGR TCZINIIR TCZDMSLE TCZSDRE3 TCZBDPRI TCZBDUAC TCZBDTOS TCZSBIRV TCZNSP01 TCZNSP02 TCZSTRMH TCZSTRMM TCZSTON TCZSTIN TCZSTLER TCZERMGR TCZUNBIS TCZEMWBK TCZVTAMO TCZVTAMK TCZVTAMA TCZTIOAE TCZSIGR TCZBRUAC TCZBDSQP TCZOPSIN TCZCLSIN TCZOPACB TCZRELIS TCZRSPER TCZSEXOS TCZCLRRV TCZVHOLD TCZLUERR TCZXSHRA TCZVRNOP TCZDEVND TCZSLSRL TCZVRDAC TCZNRLUF TCZRCLUF
Chapter 15. VTAM-associated errors

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 2 3 9 10 11 18 24 9 10 11 15 24 3 23 23 23 23 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

451

VTAM
CICS message DFHZC3477 DFHZC3479 DFHZC3480 DFHZC3481 DFHZC3482 DFHZC3484 DFHZC3485 DFHZC3486 DFHZC3487 DFHZC3488 DFHZC3489 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 Action flags set 9 10 11 24 2 3 9 10 11 24 24 AOS 2 3 9 10 11 24 Error code XAF X4E XA0 X4C XDF XC6 XC7 XC2 XC9 X3C XC8 XBF XB0 X16 X6B XC0 X21 X22 X23 X24 X25 X26 X28 X29 X2A X2B X2C X2D X2E X2F X30 X31 X33 X34 X32 XB6 XB7 XB8 XB9 XBD XB3 X35 XF1 XF3 XF4 XF5 XF6 XF7 X8A X8B X8C X8F X8D X8E Symbolic label TCZCLEAN TCZUNBFE TCZNOISC TCZDSPCL TCZDMGF TCZPASSD TCZPSPRE TCZLUINP TCZNPSAU TCZXUVAR TCZLUINH 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

24 24 24 2 3 9 10 11 18 24 18 24 24 15 24 24 3 9 10 11 24 3 9 10 11 24 3 9 10 11 24 3 9 10 11 24 3 9 10 11 24 3 9 10 11 24 3 9 10 11 24 3 9 10 11 24 2 3 9 10 11 24 2 3 9 10 11 24 2 3 9 10 11 24 2 3 9 10 11 24 2 3 9 10 11 24 2 3 9 10 11 24 2 3 9 10 11 24 2 3 9 10 11 24 2 3 9 10 11 24 2 3 9 10 11 24 N24 2 3 5 24 2 3 5 24 2 3 5 24 2 3 5 24 24 2 3 5 24 2 3 9 10 11 24 18 24 2 3 24 2 3 24 2 3 24 2 3 24 2 3 24 2 3 5 24 2 3 5 24 2 3 5 24 2 3 5 24 2 3 5 24 2 3 5 24

452

CICS TS for z/OS: CICS Users Handbook

VTAM
CICS message DFHZC4943 DFHZC4944 DFHZC4945 DFHZC4946 DFHZC4947 DFHZC6590 DFHZC6591 DFHZC6593 DFHZC6594 DFHZC6595 DFHZC6596 DFHZC6598 Action flags set 3 2 3 2 2 9 3 9 3 3 10 11 24 5 24 10 11 24 24 24 Error code XF8 XBE XA2 XF9 XFA X3F X3E X3B X3A X39 X38 X56 Symbolic label TCZFSMRB TCZBFAIL TCZPRGE TCZINVAT TCZLUSEC TCZXRST TCZXERR TCZXSBC TCZXSHR TCZXSABN TCZXSWAS TCZXRFVS

9 10 11 15 24 24 2 3 5 24 2 3 15 24

Chapter 15. VTAM-associated errors

453

VTAM

454

CICS TS for z/OS: CICS Users Handbook

Chapter 16. System sense codes received


This section contains Product-sensitive Programming Interface information. This table lists the actions taken by DFHZNAC on receipt of inbound system sense codes.
Sense code 0001 0002 0003 0004 0007 00FF 0801 0802 0806 0807 080B 080E 080F 0811 0812 081B 081C 0824 0825 0826 0827 0829 082A 082B 082D 082E 082F 0831 0833 0847 084A 084C 0860 0863 0864 0865 0866 0867 0868 0869 08FF 1000 1001 1002 1003 Message DFHZC3401 DFHZC3415 DFHZC3449 DFHZC3450 DFHZC3451 DFHZC3446 DFHZC2476 DFHZC2461 DFHZC3426 DFHZC3411 DFHZC2462 DFHZC3448 DFHZC3436 DFHZC2464 DFHZC2465 DFHZC2483 DFHZC2466 DFHZC2475 DFHZC2484 DFHZC3423 DFHZC2480 DFHZC3407 None DFHZC3408 DFHZC3413 DFHZC3412 DFHZC3414 DFHZC3438 DFHZC3427 DFHZC3439 None DFHZC3467 DFHZC3459 DFHZC3460 DFHZC2475 DFHZC2465 DFHZC2475 None DFHZC3456 DFHZC3457 DFHZC3447 DFHZC3494 DFHZC2481 DFHZC2481 DFHZC2479 Action flags set 2 2, 3, 10, 11 None None None 2, 3, 9, 10, 11, 23, 24 3, 9, 10, 11 None None None 2, 3, 9, 10, 11, 15, 24 23 9, 10, 11 9, 10, 11 2, 3 2, 3 2, 3, 9, 10, 11 3, 9, 10, 11 2, 3, 9, 10, 11 2, 3, 9, 10, 11 3 1, 2, 3, 10, 11, 24 9, 32 2, 3, 10, 11, 13 None None 2, 3, 9, 10, 11 None None None 32 9, 10, 11 None 9, 10, 11 3, 9, 10, 11 3, 9, 10, 11 3, 9, 10, 11 9, 10, 11 2, 9, 10, 11 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

Copyright IBM Corp. 1989, 2002

455

Sense code 1005 1008 1009 10FF 2003 20FF 400B 40FF 8000 8005 80FF FFFF

Message DFHZC3406 DFHZC2478 DFHZC3458 DFHZC3446 DFHZC3405 DFHZC3445 DFHZC2477 DFHZC3453 DFHZC3435 DFHZC3435 DFHZC3435 DFHZC2460

Action flags set 2, 3, 4, 9, 10, 11, 14 None 2, 9, 10, 11 2, 3, 9, 10, 11, 23, 24 2, 3, 9, 10, 11, 15, 24 2, 3, 9, 10, 11, 23, 24 1, 3, 11 2, 3, 9, 10, 11, 23, 24 2, 3, 9, 10, 11, 18, 24 2, 3, 9, 10, 11, 18, 24 2, 3, 9, 10, 11, 18, 23, 24 2, 3, 9, 10, 11, 23, 24

Message DFHZC2460 DFHZC2461 DFHZC2462 DFHZC2464 DFHZC2465 DFHZC2465 DFHZC2466 DFHZC2475 DFHZC2475 DFHZC2475 DFHZC2476 DFHZC2477 DFHZC2478 DFHZC2479 DFHZC2480 DFHZC2481 DFHZC2481 DFHZC2483 DFHZC2484 DFHZC3401 DFHZC3405 DFHZC3406 DFHZC3407 DFHZC3408 DFHZC3411 DFHZC3412 DFHZC3413 DFHZC3414 DFHZC3415 DFHZC3423 DFHZC3426 DFHZC3427 DFHZC3435 DFHZC3435 DFHZC3435 DFHZC3436 DFHZC3438

Sense code FFFF 0802 080B 0811 0812 0865 081C 0824 0864 0866 0801 400B 1008 1003 0827 1001 1002 081B 0825 0001 2003 1005 0829 082B 0807 082E 082D 082F 0002 0826 0806 0833 8000 8005 80FF 080F 0831

Action flags set 2, 3, 9, 10, 11, 23, 24 None 2, 3, 9, 10, 11, 15, 24 9, 10, 11 2, 3 3, 9, 10, 11 2, 3, 9, 10, 11 3, 9, 10, 11 3, 9, 10, 11 3, 9, 10, 11 3, 9, 10, 11 1, 3, 11 None 2, 3, 9, 10, 11, 14 3 2, 3, 9, 10, 11, 14 2, 3, 9, 10, 11, 14 2, 3 2, 3, 9, 10, 11 2 2, 3, 9, 10, 11, 15, 24 2, 3, 4, 9, 10, 11, 14 1, 2, 3, 10, 11, 24 2, 3, 10, 11, 13 None None None 2, 3, 9, 10, 11 2, 3, 10, 11 2, 3, 9, 10, 11 None None 2, 3, 9, 10, 11, 18, 24 2, 3, 9, 10, 11, 18, 24 2, 3, 9, 10, 11, 18, 23, 24 9, 10, 11 None

456

CICS TS for z/OS: CICS Users Handbook

Message DFHZC3439 DFHZC3445 DFHZC3446 DFHZC3446 DFHZC3447 DFHZC3448 DFHZC3449 DFHZC3450 DFHZC3451 DFHZC3453 DFHZC3456 DFHZC3457 DFHZC3458 DFHZC3459 DFHZC3460 DFHZC3467 DFHZC3494 None None None

Sense code 0847 20FF 00FF 10FF 08FF 080E 0003 0004 0007 40FF 0868 0869 1009 0860 0863 084C 1000 082A 084A 0867

Action flags set 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

23, 24 23, 24 23, 24 24

23, 24

Action flag settings and default actions


These are the default actions generated by DFHZNAC for DFHZNEP. The default actions can vary from the actions set, depending on the state of the node at the time of the error.
Flag 1 2 3 4 5 6 9 10 11 12 13 14 15 17 18 20 21 22 23 24 Field TWAOPT1 Bit mask 1... .... .1.. .... ..1. .... ...1 .... .... 1... .... .1.. 1... .... .1.. .... ..1. .... ...1 .... .... 1... .... .1.. .... ..1. 1... .... .1.. .... ...1 .... .... 1... .... .1.. .... ..1. .... ...1 Hex bit setting X80 X40 X20 X10 X08 X04 X80 X40 X20 X10 X08 X04 X02 X80 X40 X10 X08 X04 X02 X01 Action Print action flags Print VTAM RPL Print TCTTE Print TIOA Print BIND area System dump if no task attached Abort any send for this terminal Abort any receive for Abend any task attached to TCTTE Cancel any task attached to TCTTE Good Morning message to be sent Purge any BMS pages for this TCTTE SIMLOGON required Set INTLOG now allowed Set no internal general logons Normal CLSDST (no reset allowed) Normal CLSDST (reset allowed) Send negative response Keep node out of service CLSDST node

TWAOPT2

TWAOPT3

Chapter 16. System sense codes received

457

458

CICS TS for z/OS: CICS Users Handbook

Chapter 17. VTAM submodule identifiers


This chapter contains Product-sensitive Programming Interface information.
Hex ID X00 X01 X02 X03 X04 X06 X08 X09 X0A X0B X0C X0D X0E X10 X11 X12 X13 X14 X15 X16 X17 X18 X19 X1A X1B X1C X1D X1E X1F X20 X21 X22 X23 X24 X25 X26 X27 X28 X29 X2A X2B X2C X2E X2F X30 X31 X32 X33 Module ZDSP ZARQ ZLOC ZDET ZTCP ZCRQ ZSTU ZTSP ZHPX ZISP ZIS1 ZIS2 ZABD ZATI ZATT ZFRE ZGET ZRAC ZRST ZRVS ZRVX ZSDS ZSDX ZUCT ZUIX ZACT ZSDR ZHPS ZRPL ZAIT ZASX ZCLS ZCLX ZDWE ZLEX ZLGX ZLRP ZLTX ZOPN ZOPX ZRAQ ZRAR ZRRX ZNSP ZRSY ZSAX ZSCX ZSDA Description DISPATCH READ /WRITE R LOCATE DETACH TCP COMMAND REQS STATUS CHANGE TERMINAL SHARING HPO RPL EXEC OS ONLY ALLOCATE/FREE INTER SYSTEM INTER SYSTEM 2 INVALID REQUEST/ABEND ATI ATTACH TASK FREE STORAGE GET STORAGE RECEIVE ANY RESETSR RECEIVE SPEC RECEIVE S EXT SEND NORMAL SEND DATA EXIT TRANSLATION USER EXIT ACTIVATE SCAN SEND RESPONSE HPO SEND/RECV CALL RECV.ANY BLDER ATTACH INIT ASYN COM EXIT CLOSE DESTIN CLOSE DS EXIT DWE PROCESS LERAD EXIT LOGON EXIT LOGICAL REC LOSTERM EXIT OPEN DESTINAT OPEN DESTEXIT READAHEAD QUE READAHEAD RET REL REQUEST EX NETWORK SPEC EXIT RESYNC SEND COMM EXT SCIP EXIT SEND ASYN COM

Copyright IBM Corp. 1989, 2002

459

Hex ID X34 X35 X36 X37 X38 X39 X3A X3B X3C X3D X3E X3F X40 X41 X42 X43 X44 X45 X46 X47 X48 X49 X4A X4B X4C X4D X4E X4F X50 X52 X53 X54 X55 X56 X57 X58 X59 X5E X5F X60 X61 X62 X63 X64 X65 X66 X67 X7D X7E X7F

Module ZSKR ZSES ZSEX ZSIM ZSIX ZSLS ZSSX ZSYX ZTAX ZTPX ZOPA ZSHU ZQUE ZEMW ZSYN ZTRA ZAND ZCNA ZCNR ZCNC ZUAX ZUOX ZARL ZARM ZRVL ZRLX ZSDL ZSLX ZERH ZBKT ZCNT ZCHS ZCHR ZUSR ZDST ZEV1 ZEV2 ZXRC ZXTS ZXRL ZINT ZXRT ZSTA ZRLP ZCRT ZRAS ZXPS ZRLG ZNAC ZRSP

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

460

CICS TS for z/OS: CICS Users Handbook

Hex ID X80 X82 X84 X86 X8B XC0 XC1 XC2 XC3 XC4 XC5 XC6 XC7 XC8 XC9 XC4

Module ZATR ZATA ZATD ZGMM ZATS ZQ00 ZQIN ZQBA ZQCH ZQDL ZQIT ZQRC ZQRS ZQIQ ZQIS ZTCT

Description 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

461

462

CICS TS for z/OS: CICS Users Handbook

Chapter 18. AP domain storage classes


This chapter contains Diagnosis, Modification or Tuning information. This table shows the valid AP domain storage classes. Some classes use a 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, X01 can appear as X81.
Value X01 X02 X03 X04 X05 X06 X07 X08 X09 X0C X0D X0E X11 X12 X13 X14 X16 X20 X21 Class TERMINAL24 CICS SHARED_CICS LINE TERMINAL TASK TASK24 CICS24 SHARED_CICS24 CICS24_SAA TRANSDATA TEMPSTG USER USER24 SHARED_CICS24_SAA CONTROL TACLE SHARED_USER24 SHARED_USER SAA No No No No No No No No No Yes Yes Yes No No Yes No Yes No No

Copyright IBM Corp. 1989, 2002

463

464

CICS TS for z/OS: CICS Users Handbook

Bibliography
CICS Transaction Server for z/OS
CICS CICS CICS CICS CICS Transaction Transaction Transaction Transaction Transaction Server Server Server Server Server for for for for for z/OS z/OS z/OS z/OS z/OS Release Guide Migration Guide Installation Guide Program Directory Licensed Program Specification GC34-5983 GC34-5984 GC34-5985 GI10-2543 GC34-5987

The above titles are the only books provided automatically in hardcopy with CICS Transaction Server for z/OS, Version 2 Release 2. Several other books are available to order in hardcopy. Further information about the forms in which the published information for CICS is delivered may be found in CICS Transaction Server for z/OS Release Guide, or CICS Transaction Server for z/OS Installation Guide.

CICS books for CICS Transaction Server for z/OS


General CICS Users Handbook CICS Transaction Server for z/OS Glossary 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 Users Guide CICS C++ OO Class Libraries CICS Distributed Transaction Programming Guide CICS Business Transaction Services Java Applications in CICS 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 SC34-5986 GC34-5696 SC34-5988 SC34-5989 SC34-5990 SC34-5991 SC34-5992 SC34-5993 SC34-5994 SC34-5995 SC34-5996 SC34-5997 SC34-5998 SC34-5999 SC34-6000 SC34-6002 GC34-6003 LY33-6099 LY33-6100 SC34-6004 LY33-6101 SC34-6005 SC34-6030 SC34-6031 SC34-6006 SC34-6007 SC34-6008 SC34-6009

Copyright IBM Corp. 1989, 2002

465

CICS CICS CICS CICS CICS

IMS Database Control Guide RACF Security Guide Shared Data Tables Guide Transaction Affinities Utility Guide DB2 Guide

SC34-6010 SC34-6011 SC34-6012 SC34-6013 SC34-6014

CICSPlex SM books for CICS Transaction Server for z/OS


General CICSPlex SM Concepts and Planning CICSPlex SM User Interface Guide CICSPlex SM Commands Reference Summary CICSPlex SM Web User Interface Guide 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 SC34-6015 SC34-6016 SX33-6119 SC34-6018 SC34-6019 SC34-6020 SC34-6021 SC34-6022 SC34-6023 SC34-6024 SC34-6025 SC34-6026 SC34-6027 SC34-6028 GC34-6029

Other CICS books


Designing and Programming CICS Applications CICS Application Migration Aid Guide CICS Family: API Structure CICS Family: Client/Server Programming CICS Transaction Gateway for OS/390 Administration CICS Family: General Information CICS 4.1 Sample Applications Guide CICS/ESA 3.3 XRF Guide SR23-9692 SC33-0768 SC33-1007 SC33-1435 SC34-5528 GC33-0155 SC33-1173 SC33-0661

Note: The CICS Transaction Server for OS/390: Planning for Installation book that was part of the library for CICS Transaction Server for OS/390, Version 1 Release 3, is now merged with the CICS Transaction Server for z/OS Installation Guide. If you have any questions about the CICS Transaction Server for z/OS library, see CICS Transaction Server for z/OS Installation Guide which discusses both hardcopy and softcopy books and the ways that the books can be ordered.

Books from related libraries


You may also need to refer to relevant MVS publications.

466

CICS TS for z/OS: CICS Users Handbook

Other publications
v v v v v v v VTAM Programming, SC23-0115 IMS Database Administration Guide, SC26-4281 IMS Messages and Codes manual, SC26-4290 IMS Utilities Reference manual, SC26-4284 IMS System Administration Guide, SC26-4282 An Introduction to the IBM 3270 Information Display System, GA27-2739 MVS/DFP System Programming Reference, SC26-4567

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

Bibliography

467

468

CICS TS for z/OS: CICS Users Handbook

Accessibility
Accessibility features help a user who has a physical disability, such as restricted mobility or limited vision, to use software products successfully. You can perform most tasks required to set up, run, and maintain your CICS system in one of these ways: v using a 3270 emulator logged on to CICS v using a 3270 emulator logged on to TSO v using a 3270 emulator as an MVS system console IBM Personal Communications (Version 5.0.1 for Windows 95, Windows 98, Windows NT and Windows 2000; version 4.3 for OS/2) provides 3270 emulation with accessibility features for people with disabilities. You can use this product to provide the accessibility features you need in your CICS system.

Copyright IBM Corp. 1989, 2002

469

470

CICS TS for z/OS: CICS Users Handbook

Index C
CVDA (CICS-value data area) listed in numerical and alphabetical order 251

E
EXEC CICS commands Function codes 395 Response Codes 395

F
Function codes of EXEC CICS commands 395

R
Response Codes of EXEC CICS commands 395

Copyright IBM Corp. 1989, 2002

471

472

CICS TS for z/OS: CICS Users 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 users 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 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.

Copyright IBM Corp. 1989, 2002

473

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

474

CICS TS for z/OS: CICS Users Handbook

Microsoft, Windows and Windows NT are trademarks of Microsoft Corporation in the United States, or other countries, or both. Other company, product, and service names may be trademarks or service marks of others.

Notices

475

476

CICS TS for z/OS: CICS Users 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 ask questions, make comments about the functions of IBM products or systems, or to request additional publications, contact your IBM representative or 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: v By mail, to this address: IBM United Kingdom Limited User Technologies Department (MP095) Hursley Park Winchester Hampshire SO21 2JN United Kingdom v By fax: From outside the U.K., after your international access code use 441962816151 From within the U.K., use 01962816151 v Electronically, use the appropriate network ID: IBMLink : HURSLEY(IDRCF) Internet: idrcf@hursley.ibm.com Whichever you use, ensure that you include: v The publication title and order number v The topic to which your comment applies v Your name and address/telephone number/fax number/network ID.

Copyright IBM Corp. 1989, 2002

477

Program Number: 5697-E93

SC34-5986-06

Spine information:

CICS TS for z/OS

CICS Users Handbook

Version 2 Release 2

Вам также может понравиться