IBM SC33-1686-02 User manual

CICS Transaction Server for OS/390 IBM

CICS Supplied Transactions

Release 3

SC33-1686-02

CICS Transaction Server for OS/390 IBM

CICS Supplied Transactions

Release 3

SC33-1686-02

Note!

Before using this information and the product it supports, be sure to read the general information under “Notices” on page vii.

Third edition (March 1999)

This edition applies to Release 3 of CICS Transaction Server for OS/390, program number 5655-147, and to all subsequent versions, releases,

and modifications until otherwise indicated in new editions. Make sure you are using the correct edition for the level of the product.

This edition replaces and makes obsolete the previous edition, SC33-1686-01. The technical changes for this edition are summarized under

"Summary of changes" and are indicated by a vertical bar to the left of a change.

Order publications through your IBM representative or the IBM branch office serving your locality. Publications are not stocked at the address

given below.

At the back of this publication is a page entitled “Sending your comments to IBM”. If you want to make comments, but the methods described

are not available to you, please address them to:

IBM United Kingdom Laboratories, Information Development,

Mail Point 095, Hursley Park, Winchester, Hampshire, England, SO21 2JN.

When you send information to IBM, you grant IBM a nonexclusive right to use or distribute the information in any way it believes appropriate

without incurring any obligation to you.

US Government Users Restricted Rights – Use, duplication or disclosure restricted by GSA ADP Schedule Contract with IBM Corp.

Contents

Notices . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . vii

Trademarks . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . viii

Preface . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . ix

What this book is about .................................. ix

Who should read this book ............................... ix

What you need to know to understand this book .................... ix

How to use this book .................................. ix

Bibliography . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . xi

CICS Transaction Server for OS/390 ............................ xi

CICS books for CICS Transaction Server for OS/390 ................. xi

CICSPlex SM books for CICS Transaction Server for OS/390 ............ xii

Other CICS books ................................... xii

Books from related libraries ............................... xii

Determining if a publication is current .......................... xii

Summary of changes .................................. xv

| Changes for this edition ................................. xv

Changes for the CICS Transaction Server for OS/390 release 2 edition ........ xv

Changes for the CICS Transaction Server for OS/390 release 1 edition ........ xvi

Changes for the CICS/ESA 4.1 edition .......................... xvi

Chapter 1. Transactions supplied by CICS ....................... 1

Upgrading CICS transactions ................................ 1

How to start or stop a transaction ............................. 1

Syntax notation and conventions used in this book .................... 2

Terminal operators . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 2

MRO and ISC support ................................... 4

BMS partitions . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 4

The system console as a CICS terminal .......................... 5

Time sharing option (TSO) consoles ............................ 7

| Chapter 2. CBAM—BTS browser . . . . . . . . . . . . . . . . . . . . . . . . . . . . 9

Chapter 3. CDBC—database control menu ...................... 11

Connecting CICS to DBCTL ............................... 11

Disconnecting CICS from DBCTL ............................ 11

The HELP panel ..................................... 12

Chapter 4. CDBI—database control inquiry ..................... 13

The HELP panel ..................................... 13

Chapter 5. CDBM—database control interface .................... 15

Syntax . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 15

| DFHDBFK - The CDBM GROUP command file ..................... 16

| The MAINTENANCE panel for DFHDBFK ........................ 16

The CICS-DBCTL interface ................................ 17

The HELP panels ..................................... 17

Chapter 6. CEBR—temporary storage browse .................... 19

The HELP panel ..................................... 20

Chapter 7. CEBT—master terminal (alternate CICS) ................. 21

Minimum abbreviation of keywords ............................ 21

CEBT INQUIRE and SET commands .......................... 21

 Copyright IBM Corp. 1982, 1999 iii

CEBT PERFORM commands .............................. 25

The HELP panel ..................................... 30

Chapter 8. CECI—command-level interpreter . . . . . . . . . . . . . . . . . . . . 31

The HELP panel ..................................... 31

Command-level syntax-checking transaction (CECS) .................. 32

Chapter 9. CEDA—resource definition online .................... 33

Command syntax . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 34

CSD compatibility panel ................................. 37

Security checking . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 38

CEDA HELP panels ................................... 38

CEDB and CEDC ..................................... 40

Chapter 10. CEDF & CEDX — the execution diagnostic facility .......... 41

CEDF transaction . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 41

CEDX transaction . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 42

Chapter 11. CEMT—master terminal . . . . . . . . . . . . . . . . . . . . . . . . . 45

Starting the CEMT transaction .............................. 45

CEMT DISCARD commands ............................... 49

CEMT INQUIRE commands ............................... 53

CEMT PERFORM commands .............................. 155

CEMT SET commands .................................. 160

Chapter 12. CEOT—terminal status . . . . . . . . . . . . . . . . . . . . . . . . . . 213

CEOT in inquiry mode .................................. 213

CEOT in set mode .................................... 213

Chapter 13. CESF—sign off . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 215

Chapter 14. CESN—sign on . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 217

IBM 3270 family display devices ............................. 217

Non-3270 family terminal ................................. 218

Signing off with CESN .................................. 218

Chapter 15. CEST—supervisory terminal . . . . . . . . . . . . . . . . . . . . . . . 219

Chapter 16. CETR—trace control . . . . . . . . . . . . . . . . . . . . . . . . . . . 221

Component trace options ................................. 221

Transaction and terminal-related trace options ...................... 222

HELP panels . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 223

Chapter 17. CIND—in-doubt testing tool ....................... 227

Running the CIND in-doubt tool ............................. 227

Resource definitions . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 228

Messages . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 228

Chapter 18. CMAC—messages and codes display ................. 229

Chapter 19. CMSG—message switching . . . . . . . . . . . . . . . . . . . . . . . 231

Sending a message ................................... 231

Subsystems and terminal systems ............................ 233

Command syntax . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 234

CMSG command options ................................. 234

Message-switching responses . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 241

Examples of complete message-switching transactions ................. 245

Chapter 20. CRTE—remote transactions . . . . . . . . . . . . . . . . . . . . . . . 247

iv CICS Supplied Transactions

Chapter 21. CSFE—terminal and system test .................... 249

Terminal test . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 249

System spooling interface trace ............................. 249

Terminal builder trace .................................. 249

Debug functions . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 250

Global trap/trace program exit and global kernel exit .................. 251

Chapter 22. CSPG—page retrieval . . . . . . . . . . . . . . . . . . . . . . . . . . 253

Retrieve a page ...................................... 253

Display information about logical messages ....................... 255

Message chaining . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 255

Message termination . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 256

Copying pages . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 257

Status of hardcopy terminal ............................... 257

Routed pages displayed at terminal ........................... 257

Chapter 23. CWTO—write to console operator ................... 259

Chapter 24. DSNC—CICS DB2 transaction DSNC .................. 261

Appendix. List of CICS transactions ......................... 263

Index . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 265

Sending your comments to IBM ............................ 267

Contents v

vi CICS Supplied Transactions

Notices

This information was developed for products and services offered in the U.S.A. IBM may not

offer the products, services, or features discussed in this document in other countries.

Consult your local IBM representative for information on the products and services currently

available in your area. Any reference to an IBM product, program, or service is not intended

to state or imply that only that IBM product, program, or service may be used. Any

functionally equivalent product, program, or service that does not infringe any IBM intellectual

property right may be used instead. However, it is the user's responsibility to evaluate and

verify the operation of any non-IBM product, program, or service.

IBM may have patents or pending patent applications covering subject matter described in

this document. The furnishing of this document does not give you any license to these

patents. You can send license inquiries, in writing, to:

IBM Director of Licensing

IBM Corporation

North Castle Drive

Armonk, NY 10504-1785

U.S.A.

For license inquiries regarding double-byte (DBCS) information, contact the IBM Intellectual

Property Department in your country or send inquiries, in writing, to:

IBM World Trade Asia Corporation

Licensing

2-31 Roppongi 3-chome, Minato-ku

Tokyo 106, Japan

The following paragraph does not apply in the United Kingdom or any other country

where such provisions are inconsistent with local law:

INTERNATIONAL BUSINESS MACHINES CORPORATION PROVIDES THIS

PUBLICATION “AS IS” WITHOUT WARRANTY OF ANY KIND, EITHER EXPRESS OR

IMPLIED, INCLUDING, BUT NOT LIMITED TO, THE IMPLIED WARRANTIES OF

NON-INFRINGEMENT, MERCHANTABILITY, OR FITNESS FOR A PARTICULAR

PURPOSE. Some states do not allow disclaimer of express or implied warranties in certain

transactions, therefore this statement may not apply to you.

This publication could include technical inaccuracies or typographical errors. Changes are

periodically made to the information herein; these changes will be incorporated in new

editions of the publication. IBM may make improvements and/or changes in the product(s)

and/or the program(s) described in this publication at any time without notice.

Licensees of this program who wish to have information about it for the purpose of enabling:

(i) the exchange of information between independently created programs and other programs

(including this one) and (ii) the mutual use of the information which has been exchanged,

should contact IBM United Kingdom Laboratories, MP151, Hursley Park, Winchester,

Hampshire, England, SO21 2JN. Such information may be available, subject to appropriate

terms and conditions, including in some cases, payment of a fee.

The licensed program described in this document and all licensed material available for it are

provided by IBM under terms of the IBM Customer Agreement, IBM International

Programming License Agreement, or any equivalent agreement between us.

 Copyright IBM Corp. 1982, 1999 vii

Trademarks

The following terms are trademarks of International Business Machines Corporation in the

United States, or other countries, or both:

Java and all Java-based trademarks and logos are trademarks of Sun Microsystems, Inc. in

the United States, other countries, or both.

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

ACF/VTAM IBM

BookManager IBMLink

CICS IMS

CICS/ESA IMS/ESA

CICS/VM Language Environment

CICSPlex MQ

DB2 MVS/DFP

DFSMS OS/390

DFSMS/MVS RACF

DFSMSdss VTAM

DFSMShsm

viii CICS Supplied Transactions

Preface

What this book is about

This book tells you how to start the transactions supplied with CICS. It tells you how to

control the CICS system, how to send messages, how to collect statistics, and how to get

terminal error information. It is also useful if you are responsible for preparing procedures for

people who operate such terminals.

The book also describes how you can use the operating system console as a CICS terminal.

Who should read this book

This book is intended for CICS terminal operators and persons responsible for preparing

terminal operating procedures. It is also useful for both system and application programmers.

What you need to know to understand this book

A general knowledge of the concepts and terminology is required.

How to use this book

This book is mainly for reference. After a short introduction, the rest of the book is arranged

in alphabetic order of the transaction identifier. An index is provided to pinpoint individual

transactions and keywords.

Some CICS transactions are described in greater detail in other CICS books. These include:

In these cases, this book contains a brief description of the transaction and indicates where

further information is to be found.

Transaction CICS book

CBAM

CICS Business Transaction Services

CDBC

CICS IMS Database Control Guide

CDBI

CICS IMS Database Control Guide

CEBR

CICS Application Programming Guide

CECI

CICS Application Programming Guide

CECS

CICS Application Programming Guide

CEDA

CICS Resource Definition Guide

CEDF

CICS Application Programming Guide

CETR

CICS Problem Determination Guide

CRTE

CICS RACF Security Guide

CSFE

CICS Problem Determination Guide

DSNC

CICS DB2 Guide

Front end programming interface

Information about the Front End Programming Interface feature (FEPI) is not given in this

book. See the

CICS Front End Programming Interface User's Guide

for relevant information.

 Copyright IBM Corp. 1982, 1999 ix

Notes on terminology

 CICS refers to IBM CICS Transaction Server for OS/390 Release 3

 VTAM refers to IBM ACF/VTAM

 IMS refers to IBM IMS/ESA

 TCAM refers to the DCB interface of ACF/TCAM.

x CICS Supplied Transactions

Bibliography

CICS Transaction Server for OS/390

CICS Transaction Server for OS/390: Planning for Installation

GC33-1789

CICS Transaction Server for OS/390 Release Guide

GC34-5352

CICS Transaction Server for OS/390 Migration Guide

GC34-5353

CICS Transaction Server for OS/390 Installation Guide

GC33-1681

CICS Transaction Server for OS/390 Program Directory

GI10-2506

CICS Transaction Server for OS/390 Licensed Program Specification

GC33-1707

CICS books for CICS Transaction Server for OS/390

General

CICS Master Index

SC33-1704

CICS User's Handbook

SX33-6104

CICS Transaction Server for OS/390 Glossary

(softcopy only) GC33-1705

Administration

CICS System Definition Guide

SC33-1682

CICS Customization Guide

SC33-1683

CICS Resource Definition Guide

SC33-1684

CICS Operations and Utilities Guide

SC33-1685

CICS Supplied Transactions

SC33-1686

Programming

CICS Application Programming Guide

SC33-1687

CICS Application Programming Reference

SC33-1688

CICS System Programming Reference

SC33-1689

CICS Front End Programming Interface User's Guide

SC33-1692

CICS C++ OO Class Libraries

SC34-5455

CICS Distributed Transaction Programming Guide

SC33-1691

CICS Business Transaction Services

SC34-5268

Diagnosis

CICS Problem Determination Guide

GC33-1693

CICS Messages and Codes

GC33-1694

CICS Diagnosis Reference

LY33-6088

CICS Data Areas

LY33-6089

CICS Trace Entries

SC34-5446

CICS Supplementary Data Areas

LY33-6090

Communication

CICS Intercommunication Guide

SC33-1695

CICS Family: Interproduct Communication

SC33-0824

CICS Family: Communicating from CICS on System/390

SC33-1697

CICS External Interfaces Guide

SC33-1944

CICS Internet Guide

SC34-5445

Special topics

CICS Recovery and Restart Guide

SC33-1698

CICS Performance Guide

SC33-1699

CICS IMS Database Control Guide

SC33-1700

CICS RACF Security Guide

SC33-1701

CICS Shared Data Tables Guide

SC33-1702

CICS Transaction Affinities Utility Guide

SC33-1777

CICS DB2 Guide

SC33-1939

 Copyright IBM Corp. 1982, 1999

xi

CICSPlex SM books for CICS Transaction Server for OS/390

General

CICSPlex SM Master Index

SC33-1812

CICSPlex SM Concepts and Planning

GC33-0786

CICSPlex SM User Interface Guide

SC33-0788

CICSPlex SM View Commands Reference Summary

SX33-6099

Administration and Management

CICSPlex SM Administration

SC34-5401

CICSPlex SM Operations Views Reference

SC33-0789

CICSPlex SM Monitor Views Reference

SC34-5402

CICSPlex SM Managing Workloads

SC33-1807

CICSPlex SM Managing Resource Usage

SC33-1808

CICSPlex SM Managing Business Applications

SC33-1809

Programming

CICSPlex SM Application Programming Guide

SC34-5457

CICSPlex SM Application Programming Reference

SC34-5458

Diagnosis

CICSPlex SM Resource Tables Reference

SC33-1220

CICSPlex SM Messages and Codes

GC33-0790

CICSPlex SM Problem Determination

GC33-0791

Other CICS books

If you have any questions about the CICS Transaction Server for OS/390 library, see

CICS

Transaction Server for OS/390: Planning for Installation

which discusses both hardcopy and

softcopy books and the ways that the books can be ordered.

CICS Application Programming Primer (VS COBOL II)

SC33-0674

CICS Application Migration Aid Guide

SC33-0768

CICS Family: API Structure

SC33-1007

CICS Family: Client/Server Programming

SC33-1435

CICS Family: General Information

GC33-0155

CICS 4.1 Sample Applications Guide

SC33-1173

CICS/ESA 3.3 XRF Guide

SC33-0661

Books from related libraries

The reader of this book may also want to refer to the following IBM publications:



OS/390 MVS System Commands

, GC28-1781



Resource Access Control Facility (RACF): Security Administrator’s Guide

, SC28-1340



IMS Utilities Reference manual

, SC26-4284



IMS Messages and Codes manual

, SC26-4290



IMS System Administration Guide

, SC26-4278



IMS Operations Guide

, SC26-4287



An Introduction to the IBM 3270 Information Display System

, GA27-2739



Systems Network Architecture—LU6.2 Reference: Peer Protocols

, SC31-6808



MVS/DFP 3.2 System Programming Reference

manual, SC26-4567



OS/390 MVS Diagnosis: Tools and Service Aids

, SY28-1085

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.

xii CICS Supplied Transactions

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 xiii

xiv CICS Supplied Transactions

Summary of changes

This edition is based on the CICS Transaction Server for OS/390 Release 2 edition,

SC33-1686-01. Changes for this edition are marked by vertical bars to the left of the text.

|

Changes for this edition

| Changes include:

|  The CEMT transaction is extended to support the new resource types:

| – DOCTEMPLATE

| – ENQMODEL

| – PROCESSTYPE

| – REQUESTMODEL

| – TCPIPSERVICE

| – TSMODEL

| also added to CEMT are the following:

| – INQUIRE CFDTPOOL

| – INQUIRE ENQ

| – INQUIRE RRMS

| – INQUIRE TCPIP and SET TCPIP

| – INQUIRE TSPOOL

| – INQUIRE TSQNAME and SET TSQNAME

| – INQUIRE TSQUEUE and SET TSQUEUE

| – INQUIRE WEB and SET WEB

| and there are changes to

| – CEMT INQUIRE FILE and SET FILE in support of coupling facility data tables

| – CEMT INQUIRE PROGRAM and CEMT SET PROGRAM to support running JAVA

| applications under the control of a Java Virtual Machine (JVM).

|  The new CBAM transaction (described in Chapter 2, “CBAM—BTS browser” on

| page 9).

|  The CDBM transaction is extended to support storing of commands for reuse, and

| issuing of stored commands.

Changes for the CICS Transaction Server for OS/390 release 2 edition

Changes included:

 The CDEX transaction

 Addition of BRIDGE and IDENTIFIER to CEMT INQUIRE TASK.

 Addition of BREXIT and FACILITYLIKE to CEMT INQUIRE TRANSACTION.

 The CICS DB2 attachment facility is enhanced to provide resource definition online

(RDO) support for DB2 resources as an alternative to resource control table (RCT)

definitions. The following CEMT INQUIRE, and SET, commands are added:

– CEMT INQUIRE|SET DB2CONN

– CEMT INQUIRE|SET DB2ENTRY

– CEMT INQUIRE|SET DB2TRAN

 The CEMT DISCARD command is extended to allow the resource definitions

DB2CONN. DB2ENTRY, and DB2TRAN to be discarded.

 The CEDA check function is enhanced to perform consistency checks on the new DB2

objects.

 Copyright IBM Corp. 1982, 1999 xv

Changes for the CICS Transaction Server for OS/390 release 1 edition

This edition is based on the CICS/ESA 4.1

CICS-Supplied Transactions

manual

(SC33-0710-00).

For CICS Transaction Server for OS/390, the following changes have been made:

 Removal of local DL/I and CEMT INQUIRE and SET PITRACE

 Addition of CEMT DISCARD JMODEL, CEMT DISCARD JOURNALNAME, CEMT

DISCARD TDQUEUE, CEMT INQUIRE EXCI (replacing CEMT INQUIRE IRBATCH),

CEMT INQUIRE JMODEL, CEMT INQUIRE JOURNALNAME, CEMT INQUIRE

STREAMNAME, CEMT INQUIRE UOW, CEMT INQUIRE UOWDSNFAIL, CEMT

INQUIRE UOWENQ, CEMT INQUIRE UOWLINK, CEMT PERFORM ENDAFFINITY,

CEMT SET JOURNALNAME, CEMT SET UOW, and CEMT SET UOWLINK commands

 New options on the CEMT INQUIRE CONNECTION, CEMT INQUIRE DSNAME, CEMT

INQUIRE FILE, CEMT INQUIRE NETNAME, CEMT INQUIRE TASK, CEMT INQUIRE

TDQUEUE, CEMT INQUIRE TERMINAL, CEMT PERFORM SHUTDOWN, CEMT

PERFORM STATISTICS RECORD, CEMT SET CONNECTION, CEMT SET DSNAME,

and CEMT SET TDQUEUE commands.

Changes for the CICS/ESA 4.1 edition

This edition is based on the CICS/ESA 3.3

CICS-Supplied Transactions

manual

(SC33-0669-02).

For CICS/ESA 4.1, the following changes have been made:

 CEMT INQUIRE CONNECTION has been enhanced to display more information.

 CEMT INQUIRE|SET DSAS has been added.

 CEMT INQUIRE|PERFORM|SET DELETSHIPPED has been added.

 RELATED and LOCAL options have been added to the CEMT INQUIRE

SYDUMPCODE and TRDUMPCODE commands and to the CEMT SET SYDUMPCODE

and TRDUMPCODE commands.

 CEMT, CEDA, and CETR now show the SYSID alongside the APPLID.

 CEDA now shows the resource type and resource name in all the View, Alter, and

Define panels.

 In CEMT INQ|SET SYSTEM, the CSCS, ECSCS, ERSCS, EUSCS, and USCS

operands have been removed, and the DSALIMIT, EDSALIMIT, ESDASIZE, RDSASIZE,

SDSASIZE, and TRANISOLATE operands have been added. In addition, the definitions

have been changed for the CDSASIZE, ECDSASIZE, ERDSASIZE, and EUDSASIZE

operands. The DTRTRANSID, PROGAUTOCTLG, PROGAUTOEXIT, and

PROGAUTOINST operands have also been added. FEPI and PROGAUTO options are

added to the CEMT PERFORM STATISTICS command.

In addition, many editorial changes have been made to clarify the information in this manual.

xvi CICS Supplied Transactions

introduction

Chapter 1. Transactions supplied by CICS

CICS provides operations, usually initiated from terminals,

called

transactions

, each of which involves the use of CICS

tables, programs, and internal services. This book deals with

those transactions that are supplied by CICS and which, in

addition, have an operator interface.

CICS transactions have identification codes that start with “C”

and are 4 characters long; for example, CEMT.

The following table shows the transactions that are described

in this book. For a more complete list of CICS transactions,

including those that do not have an operator interface, see

the Appendix, “List of CICS transactions” on page 263.

In general, you start a CICS transaction by entering its

transaction identifier (for example, CEMT). The transaction

identifier is used by CICS to identify the programs that

handle the specified transactions, and to establish a task to

process them.

If you use an IBM 3270 system display or similar display

device that has the appropriate features installed, you can

also start a transaction by a program function (PF) key or

program attention (PA) key, by an operator identification card

reader, by a magnetic slot reader, or by a light pen. For other

types of terminals or subsystems, see the appropriate

CICS/OS/VS subsystem guide.

Upgrading CICS transactions

You may wish to apply a CICS-supplied upgrade, but are

using modified versions of one or more CICS-supplied

transactions or of the CICS-supplied calling programs that

handle CICS-supplied transactions. After you have first

copied them to differently named groups, you must replace

these private versions from the upgraded CICS-supplied

version and modify them afresh to ensure that the necessary

upgrade changes are carried out. Failure to do this can lead

to unpredictable results.

How to start or stop a transaction

You start a CICS transaction by pressing the CLEAR key to

clear the screen, and entering the transaction identifier, either

by itself or followed by data, on the command line of the

screen. The command line is a single line, usually at the top

of the screen.

You can type the transaction identifier by itself and follow the

prompts until a complete transaction command is built up, or

you can type the complete transaction command on the

command line. If you do not enter enough information, or if

the information you enter is wrong, you are prompted to

complete or correct your input.

For example, in the following transaction, CEMT is the

transaction identifier and the additional data is INQUIRE

PROGRAM(PROG1).

CEMT INQUIRE PROGRAM(PROG1)

When the transaction starts, it processes the additional data.

At the completion of this transaction, you get the following

message:

STATUS: SESSION ENDED

After a transaction has completed, press the CLEAR key to

clear the screen in readiness for the next transaction. You

can cancel any request by typing CANCEL on the command

line.

Function Name Page

| CICS business transaction

| services (BTS) browser

| CBAM| 9

Command-level interpreter CECI,

CECS

31

Database control inquiry CDBI 13

Database control interface CDBM 15

Database control menu CDBC 11

Execution diagnostic facility CEDF 41

CEDX 41

In-doubt testing tool CIND 227

Master terminal CEMT 45

Master terminal (alternate CICS) CEBT 21

Messages and codes display CMAC 229

Message switching CMSG 231

Page retrieval CSPG 253

Remote transactions CRTE 247

Resource definition online

(RDO)

CEDA,

CEDB,

CEDC

33

Sign off CESF 215

Sign on CESN 217

Supervisory terminal CEST 219

Temporary-storage browse CEBR 19

Terminal status CEOT 213

Trace control CETR 221

Terminal and system test CSFE 249

Write to console operator CWTO 259

 Copyright IBM Corp. 1982, 1999

1

introduction

Syntax notation and conventions used in

this book

Each command has a syntax box to show you what options

there are.

You interpret the syntax by following the arrows from left to

right. The conventions are:

Minimum abbreviation of keywords

In general, the CICS transactions accept as few characters

of a keyword as needed to identify it within the request. For

example, in a CEMT INQUIRE TASK command, you could

use TASK, TAS, or TA to uniquely identify TASK. T alone,

however, could be confused with TCLASS, TERMINAL,

TRACE, or TRANSACTION.

In the syntax displays on your screen (unless your terminal is

uppercase only), and in most cases in this book, the

minimum permitted abbreviation is given in uppercase

characters, the remainder in lowercase.

Uppercase input to transactions

In general, most CICS-supplied transactions accept only

uppercase input. If UCTRAN=YES has been specified in the

terminal definition, all lowercase characters, even those

enclosed within single quotation marks, are translated to

uppercase.

If you have to specify UCTRAN=NO for your terminal, you

have to ensure that the group specified for your terminal

refers to a profile that will carry out uppercase translation.

CICS provides a PROFILE definition, DFHCICSP, in the

DFHSTAND group in the CICS system definition (CSD) file.

This profile is identical to DFHCICST except that it specifies

UCTRAN(YES) instead of UCTRAN(NO).

The new profile is used by the CICS-supplied page retrieval

transaction, CSPG. The new profile, together with changes in

the task-attach routine and the page retrieval program,

enables CICS to perform uppercase translation at the

transaction level for BMS paging.

This allows users of terminals that are defined with

uppercase translation switched off to use the page retrieval

function without having to enter paging commands in upper

case. Assigning a new profile for CSPG means that all data

entered on the retrieval command (defined by the PGRET

system initialization parameter) and the purge command

(defined by the PGPURGE system initialization parameter) is

translated to uppercase.

If a user’s terminal is defined with UCTRAN(YES), the new

profile has no effect because all terminal input is translated

to uppercase anyway.

Terminal operators

A CICS system makes provision for the following classes of

operators:

 A

terminal operator

who can use a terminal to perform

routine transactions that cause application programs to

be processed. You can use a small selection of CICS

transactions. For example, you can inquire about, or

change, the status of your own terminal.

 A

supervisory terminal operator

who can perform all the

duties of a terminal operator, in addition to supervising

other operators within a functional group. Your operator

security code gives you access to the supervisory

terminal transaction, CEST, with which you can monitor

and control some of the system resources used by your

group.

 A

master terminal operator

who can monitor and control

resources in a CICS system. Your operator security

code gives you access to the master terminal

transaction, CEMT, with which you monitor and control

the system resources. Internal security checking may

limit the range of resources under your control.

Symbol Action

─ ──┬ ┬─A─ ────

├┤─B─

└┘─C─

A set of alternatives—one of which you

must

code.

┌ ┐───────

─ ───



┴┬┬─A─ ──

├┤─B─

└┘─C─

A set of alternatives—one of which you

must

code. You

may

code more than

one of them, in any sequence.

─ ──┬ ┬─── ────

├┤─A─

├┤─B─

└┘─C─

A set of alternatives—one of which you

may

code.

┌ ┐───────

─ ───



┴┬┬─── ──

├┤─A─

├┤─B─

└┘─C─

A set of alternatives — any number

(including none) of which you may code

once, in any sequence.

┌┐─A─

─ ──┼ ┼─── ────

└┘─B─

Alternatives where A is the default.

──┤ Name ├──

Name:

├─ ──A ──┬ ┬─── ───┤

└┘─B─

Use with the named section in place of its

name.

Punctuation and

uppercase

characters

Code exactly as shown.

Lowercase

characters

Code your own text, as appropriate (for

example, name).

2 CICS Supplied Transactions

Page is loading ...

IBM SC33-1686-02 User manual

Related papers

Other documents