IBM SC33-1683-02 manuals

Ibm SC33-1683-02 User Manual (875 pages)

Brand: Ibm | Category: Computers | Size: 3.19 MB |

CICS Customization Guide

Contents

Contents v

Contents vii

Contents ix

Contents xi

Contents xiii

Contents xv

Trademarks

What this book is about

Who this book is for

How to use this book

Notes on terminology

Bibliography

Other CICS books

Books from related libraries

ACF/TCAM books

MVS books

VTAM books

Other related books

Summary of changes

Summary of changes xxix

Performance Guide

Global user exit programs

Using CICS services

The global work area

Making trace entries

DFHUEPAR standard parameters

12 (decimal)

12 (decimal) in this

Returning values to CICS

Errors in user exit programs

The DFH$PCPI program:

Sample program deﬁnitions:

Resource Deﬁnition Guide

CICS Shared Data

Tables Guide

Exit XAKUSER

WRITE JOURNALNAME

Important

Basic Mapping Support exits

Exit XBMIN

Exit XBMOUT

Programming the XBMIN exit

Programming the XBMOUT exit

Cumulative mapping operations

Message routing

Bridge facility exit

Exit XFAINTU

Exit XDTRD

Exit XDTAD

Exit XDTLC

Exit XXDFB

Exit XXDTO

Exit XDSBWT

Exit XDSAWT

DL/I interface program exits

Exit XDLIPRE

Exit XDLIPOST

Exit XDUREQ

Exit XDUREQC

Exit XDUCLSE

Exit XDUOUT

Exit XNQEREQ

Exit XNQEREQC

Sample exit program, DFH$XNQE

The command parameter list

Bypassing commands

Exit XEIIN

Exit XEISPIN

Exit XEIOUT

100

Exit XEISPOUT

100

EXEC interface program exits

101

Modifying input ﬁelds

107

Modifying the EID

108

Use of the parameter UEPFSHIP

109

Exit XFCREQ

111

Exit XFCREQC

112

Example program

114

Exit XFCAREQ

116

Exit XFCAREQC

117

Modifying user arguments

127

Exit XFCSREQ

129

Exit XFCSREQC

132

Recovery and Restart Guide

137

Exit XFCNREC

138

Exit XFCVSDS

140

ﬁle control quiesce send exit

142

Order of invocation

144

Migration note

149

The XISCONA exit

159

Exit XISCONA

160

CICS Performance Guide

161

The XISLCLQ exit

162

Exit XICREQ

164

Exit XICEXP

165

Exit XICTENF

165

XICEREQC

166

Exit XICEREQ

166

Exit XICEREQC

167

Modifying output ﬁelds

174

Using the task token UEPTSTOK

177

CICS Intercommunication Guide

178

Exit XLDLOAD

179

Exit XLDELETE

180

OS/390 MVS Authorized

181

Exit XLGSTRM

182

Message domain exit XMEOUT

184

Exit XMEOUT

185

Monitoring domain exit XMNOUT

188

Exit XMNOUT

188

XPCHAIR, XPCTA, and XPCABND

190

XPCREQ and XPCREQC

190

Exit XPCREQC

191

Modifying input ﬁelds:

194

Modifying output ﬁelds:

194

In XPCREQ:

196

In XPCREQC:

196

Exit XPCFTCH

197

Exit XPCHAIR

198

Exit XPCTA

200

Exit XPCABND

201

Exit XRMIIN

203

Exit XRMIOUT

204

Exit XRSINDI

205

Exit XSNON

209

Exit XSNOFF

210

UERCPURG

211

Task purged during XPI call

211

XPI calls

211

All can be used

211

Statistics domain exit XSTOUT

212

Exit XSTOUT

212

Exit XSRAB

214

could be determined

215

CICS Data Areas

216

Exit XSTERM

218

XTSPTOUT

219

Exit XTSQRIN

219

Exit XTSQROUT

220

Exit XTSPTIN

222

Exit XTSPTOUT

223

XTSEREQC

225

Exit XTSEREQ

226

Exit XTSEREQC

227

Command See

228

WRITEQ TS Table 7 on page 200

228

READQ TS Table 8 on page 200

228

Adding user arguments

233

Removing user arguments

233

Exit XALCAID

235

Exit XTCIN

237

Exit XTCOUT

237

Exit XTCATT

238

Exit XTCTIN

238

Exit XTCTOUT

239

The exits

240

Exit XALTENF

241

Exit XXMATT

248

Exit XTDREQ

250

Exit XTDIN

251

Exit XTDOUT

252

XTDEREQC

253

Exit XTDEREQ

253

Exit XTDEREQC

255

Coding the exit programs

262

Enabling the exit programs

263

Exit XRCINIT

264

Exit XRCINPT

264

Exit XZCATT

266

Exit XZCIN

267

Exit XZCOUT

267

Exit XZCOUT1

268

VTAM working-set module exits

269

Exit XZIQUE

272

Design considerations

275

Sample exit program design

276

Exit XXRSTAT

278

The stub program

282

Figure 5. The stub concept

283

User exit parameter lists

285

Caller parameter lists

289

CICS task manager parameters:

292

CICS EDF build parameters:

293

The schedule ﬂag word

297

Saving CICS registers

298

Addressing-mode implications

299

Work areas

301

CICS System

302

Programming Reference

302

Return codes

303

Limitations

304

Resynchronization

306

(Part 1 of 2)

309

(Part 2 of 2)

310

) and (E

311

) expressions in Figure 10

311

Adapter administration

312

The administration routines

313

TRACETYPE command

314

Overview

315

General form of an XPI call

318

DFHUEXIT TYPE=XPIENV

322

XPI register usage

323

The XPI copy books

323

XPI examples

325

The XPI functions

330

OPTION(addr,len)

331

OPTION(bufdname)

331

OPTION(addr,maxlen,*)

331

Dispatcher functions

332

The ADD_SUSPEND call

334

The SUSPEND call

336

The RESUME call

339

The DELETE_SUSPEND call

340

The WAIT_MVS call

341

CICS Problem Determination

343

The CHANGE_PRIORITY call

345

Dump control functions

346

The SYSTEM_DUMP call

346

RESPONSE REASON

347

The TRANSACTION_DUMP call

348

Enqueue domain functions

350

The ENQUEUE function

350

The DEQUEUE function

351

Kernel domain functions

352

Loader functions

353

The DEFINE_PROGRAM call

353

The ACQUIRE_PROGRAM call

357

The RELEASE_PROGRAM call

359

The DELETE_PROGRAM call

360

Log manager functions

361

The INQUIRE_PARAMETERS call

361

The SET_PARAMETERS call

361

Monitoring functions

362

The MONITOR call

362

CICS Resource Deﬁnition Guide

363

Program management functions

366

The INQUIRE_PROGRAM call

367

Intercommunication Guide

368

The SET_PROGRAM call

375

The START_BROWSE_PROGRAM call

378

The GET_NEXT_PROGRAM call

379

The END_BROWSE_PROGRAM call

381

The INQUIRE_AUTOINSTALL call

382

The SET_AUTOINSTALL call

382

State data access functions

384

The INQ_APPLICATION_DATA call

384

The INQUIRE_SYSTEM call

387

The SET_SYSTEM call

391

Storage control functions

393

The GETMAIN call

393

The FREEMAIN call

396

The INQUIRE_ACCESS call

396

INQUIRE_ELEMENT_LENGTH:

398

The INQUIRE_TASK_STORAGE call

399

The SWITCH_SUBSPACE call

400

Trace control function

401

The TRACE_PUT call

401

The INQUIRE_CONTEXT call

402

The INQUIRE_DTRTRAN call

403

The INQUIRE_MXT call

404

The INQUIRE_TCLASS call

406

The INQUIRE_TRANDEF call

407

The INQUIRE_TRANSACTION call

415

The SET_TRANSACTION call

419

User journaling function

420

The WRITE_JOURNAL_DATA call

420

Initialization programs

425

First phase PLT programs

425

Second phase PLT programs

426

Shutdown programs

426

General considerations

428

Storage keys for PLT programs

428

PLT programs—general

429

IBM ESA/370 Principles of

433

Operation

433

CICS System Deﬁnition Guide

434

CICS Recovery and

439

Restart Guide

439

Terminal control program

448

Terminal error program

448

The communication area

449

TEP error table

450

TEP default table

451

Entry and initialization

452

Error processor selection

452

Error processing execution

452

General exit

453

Common subroutines

453

DFHTEPM TYPE=USTOR

458

DFHTEPM TYPE=USTOREND

458

DFHTEPM macro examples

462

DFHTEPT TYPE=INITIAL

464

,MAXTIDS=number

464

[,MAXERRS={25

464

[,OPTIONS={TIME

464

Name Type Description Library

470

CICSTS13.CICS.SDFHMAC

470

increased by

473

8 in real TCTLE)

473

USING DFHTCTTE,TCTTEAR

474

DROP TCTLEAR

474

USING DFHTCTLE,TCTLEAR

474

CICS Intercommunication

481

An overview of writing a NEP

483

The default NEP

484

The sample NEP

484

Coding the sample NEP

485

Multiple NEPs

487

The sample node error program

497

Entry section

498

Routing mechanism

499

Node error table

499

Optional common subroutines

500

Table 22. Register assignment

504

Entry and addressability

508

Coding for session failures

509

Writing multiple NEPs

510

DFHZNEPI macros

510

CICS/ESA 3.3 XRF

512

Changing the recovery message

514

Preliminary considerations

517

Coding entries for MTS

519

SNA Network Product Formats

520

Returning information to CICS

523

CICS Resource Deﬁnition

524

Setting the TERMINAL name

525

WAS MODEL_NAME: mmmmmmmm

526

CINIT BIND: cccccccc...

526

MODEL BIND: bbbbbbbb...

526

MISMATCH BITS: xxxxxxxx

526

Testing and debugging

528

Deﬁnition Guide

530

Assembler language

531

Leaving it all to CICS

537

Beneﬁts of autoinstall

546

Requirements for autoinstall

546

Recovery and restart

547

Resource deﬁnitions

553

CICS-generated aliases

556

Autoinstall models

563

Terminal identiﬁers

564

Why override TERMIDs?

565

Autoinstall model deﬁnitions

572

System autoinstall

573

Saving in virtual storage

573

Faster startup times

574

Resource deﬁnition

579

Dynamic transaction routing

582

Dynamic transactions

582

Changing the program name

585

CICS Application Programming

587

Monitoring the output TIOA

588

Unit of work considerations

589

Changing the transaction ID

592

‘tranid’

598

Reference

599

System Programming Reference

605

CICS Business Transaction

611

Services

611

CICS System Programming

612

External Interfaces Guide

631

CICS Internet Guide

633

Environment variables

635

IBM ESA/370 Principles

640

The sample overseer program

641

The display function

642

The restart-in-place function

643

CICS Operations and

644

Utilities Guide

644

The DFHWOSM macros

646

The DFHWOSM tokens

647

DFHWOSM FUNC=BUILD macro

647

DFHWOSM FUNC=CLOSE macro

648

DFHWOSM FUNC=DSECT macro

648

DFHWOSM FUNC=JJC macro

648

DFHWOSM FUNC={JJS

649

DFHWOSM FUNC=OPEN macro

650

DFHWOSM FUNC=OSCMD macro

650

DFHWOSM FUNC=READ macro

651

DFHWOSM macros

652

DFHWOSM FUNC=TERM macro

654

Loop or wait detection

656

IBM ESA/370

660

Principles of Operation

660

Log stream storage

661

Primary storage

662

Tertiary storage

662

Secondary storage

662

Fixed length

666

Reserved

667

Start-of-run record

668

Format of caller data

668

Variable length

669

FLJB GENERAL DATA

672

FLJB DELETE DATA

672

Fixed length Variable length

672

Base key Path key

672

File-close record types

673

Tie-up record types

674

Terminal control preﬁx data

676

FEPI preﬁx data

676

System header

680

User prefix Journal data

680

System prefix

680

Variable

682

The SMF block header

686

The CICS product section

686

The CICS data section

687

Chapter 24. CICS monitoring

689

DFHMCT TYPE=EMP

691

DFHMCT TYPE=RECORD

691

Examples of MCT coding

692

Exception class data

693

Controlling CICS monitoring

694

CICS Supplied Transactions

695

OS/390 MVS System Management

697

Facilities (SMF)

697

CICS data section

698

Performance data sections

704

Exception data sections

706

CICS Performance

707

Chapter 25. CICS statistics

709

Resetting statistics counters

713

CICS statistics record format

714

STSMFDS DFHSTSMF PREFIX=SMF

715

CICS statistics data section

717

CICS with TCAM SNA

724

Protocol management

724

Transaction control

725

Batch processing

726

Error processing

726

The CICS-TCAM interface

727

Data format

728

Logic ﬂow

729

Segment processing

732

Line pool speciﬁcations

733

Line locking

734

TCAM queues

735

TCAM devices

736

TCAM with 3270 devices

738

TCAM user exits

739

Starting and terminating TCAM

739

CICS-TCAM startup

739

CICS-TCAM abend and restart

739

CICS-TCAM termination

740

TCAM MCP

741

CICS Application program

741

Terminal operation

746

Help feature

747

DYNALLOC ﬂow of control

749

CICS RACF Security

752

The MVS router

753

The MVS router exit

754

Router exit return codes

755

ESM exit programs

756

CICS security control points

759

Early veriﬁcation processing

761

INCLUDE SYSLIB(DFHXSEAI)

763

INCLUDE SYSLIB(DFHEAI)

763

ENTRY verify-program

763

*ASM XOPTS(NOPROLOG,NOEPILOG)

763

What the sample program does

768

An overview of DFHCSDUP

773

DFHCSDUP as a batch program

774

The EXTRACT command

774

The sample EXTRACT programs

776

The DB2 formatting program

778

An assembler-language version

780

A VS COBOL II version

781

A PL/I version

782

Entry parameters for DFHCSDUP

784

The initialization exit

787

The get-command exit

788

The extract exit

789

The put-message exit

791

The sample program, DFH$CUS1

792

COMMAREA(CEDAPARM)

793

CICS Distributed

794

Transaction Programming Guide

794

DFHEDAP in a DTP environment

795

Part 9. Appendixes

797

TYPETERM device types

800

VTAM MODEENT macro operands

802

PSERVIC screen size values

807

Messages and Codes

821

CICS Messages and Codes

832

(DFH$TDWT)

835

Using the XZCIN exit

837

Using DFHTCTDY

837

TS data sharing messages

838

Special Characters

855

Numerics

855

(continued)

856

Index 827

859

Sending your comments to IBM

873

SC33-1683-02

874

Spine information:

875

More products and manuals for Computers IBM

Models	Document Type
H SERIES RS/6000	User Manual IBM H SERIES RS/6000 User Manual, 290 pages
3.1	User Manual IBM 3.1 User Manual, 12 pages
xSeries 330	User Manual IBM xSeries 330 User Manual, 158 pages
SC34-6814-04	User Manual IBM SC34-6814-04 User Manual, 953 pages
System x3400	User Manual IBM System x3400 User Manual, 15 pages
TotalStorage DS6000 Series	User Manual IBM TotalStorage DS6000 Series User Manual, 406 pages
6274	User Manual IBM 6274 User Manual, 96 pages
525	User Manual IBM 525 User Manual, 33 pages
2196	User Manual IBM 2196 User Manual [en] [de] [es] [fr] [it] , 208 pages
Motherboard DJ800	User Manual IBM Motherboard DJ800 User Manual, 56 pages
310ED	User Manual IBM 310ED User Manual, 120 pages
HANDBOOK 260	User Manual IBM HANDBOOK 260 User Manual, 286 pages
Aptiva 2142	User Manual IBM Aptiva 2142 User Manual, 212 pages
2274	User Manual IBM 2274 User Manual, 183 pages
Z10 BUISNESS CLASS Z10 BC	User Manual IBM Z10 BUISNESS CLASS Z10 BC User Manual, 67 pages
6643	User Manual IBM 6643 User Manual, 128 pages
X3650 M3	User Manual IBM X3650 M3 User Manual, 21 pages
CICS Transaction Server for OS/390 SC33-1686-02	User Manual IBM CICS Transaction Server for OS/390 SC33-1686-02 User Manual, 317 pages
MS-7236 (V2.X) Mainboard G52-72361X2	User Manual IBM MS-7236 (V2.X) Mainboard G52-72361X2 User Manual, 85 pages
F50 RS/6000 7025	User Manual IBM F50 RS/6000 7025 User Manual, 364 pages

IBM SC33-1683-02 manuals

Ibm SC33-1683-02 User Manual (875 pages)

Table of contents

More products and manuals for Computers IBM

IBM devices