index [ptgmedia.pearsoncmg.com]ptgmedia.pearsoncmg.com/images/0131856715/index/... · index symbols...

525

INDEX

Symbols

//DFSSTAT reports, 415/ACTIVATE command, 422/ASSIGN command

ETO, 423to change LTERM to subpool, 423to modify regions, 422to modify terminals, 422to modify transactions, 422

/CHANGE command, 424/CHECKPOINT SNAPQ, 420/COMPT command, 422/DBDUMP command, 423/DBRECOVERY command, 423/DEQUEUE command, 422, 423/DISPLAY command

CONV, 424for dead letter status, 423terminals, 422

/ERESTART command, 420/IDLE command, 422/MSASSIGN command, 424/MSVERIFY command, 424/NRESTART command, 420/RMGENJCL command, 387

/RSTART command, 422/START command

address spaces, starting, 53setting share level, 393

/STOP command, 424/TRACE command

diagnosing problems with, 406for program isolation, 416IMS Monitor, 414VTAM I/O Timeout facility, 422

Numerics

2972/2980 Input edit routine (DFS29800), 3524701 Transaction Input edit routine

(DFS36010), 352

A

ACB (application control block), generating, 230

access intent, 391access methods

generalized sequential access method (GSAM), 107

6202 Meltz.bk Page 525 Thursday, December 9, 2004 12:48 PM

526 Index

Hierarchical Direct Access Method (HDAM), 89

Hierarchical Indexed Direct Access Method (HIDAM), 94

Overflow Sequential Access Method (OS-AM), 109

partitioned HDAM databases (PHDAM), 97

partitioned HIDAM databases (PHIDAM), 97

Virtual Storage Access Method (VSAM), 109

z/OS access methodsused by HD, 98

access pathslogical relationships, 73secondary relationships, 73segment search argument (SSA), 243

accessingDB2 for z/OS, 237IMS

from application programs, 17from other products, 22using DL/I, 17using JDBC, 17with TCP/IP, 25

ACTIVATE (/ACTIVATE) command, 422address spaces

Common Queue Server (CQS), 40control, 28DBRC, 36dependent

application, 36batch message processing (BMP), 38DBCTL thread (DBT), 37Fast Path (IFP), 38introduction to, 36Java batch processing (JBP), 39Java message processing (JMP), 39message processing region (MPR), 37

DLISAS, 36generating, 43internal resource lock manager (IRLM), 43introduction to, 28IRLM (internal resource lock manager), 43Operations Manager (OM), 42

Resource Manager (RM), 42SCI (Structured Call Interface), 42separate address spaces

DBRC, 36DL/I, 36

starting, 53Structured Call Interface (SCI), 42

administration, MFS, 304Advanced Program-to-Program Communica-

tions (APPC)editing and formatting, 297IMS support of, 47using in a sysplex, 478

AIB (application interface block)AIBERRXT (reason code), 223AIBID (AIB identifier), 222AIBOALEN (maximum output area

length), 223AIBOAUSE (used output area length), 223AIBREASN (reason code), 223AIBRSA1 (resource address), 223AIBRSNM1 (resource name), 222AIBSFUNC (subfunction code), 222DFSAIB allocated length (AIBLEN), 222fields, 221introduction to, 218mask, 222, 223specifying, 221

AIBERRXT (reason code), 223AIBID (AIB identifier) field, AIB mask, 222AIBLEN (DFSAIB allocated length) field, AIB

mask, 222AIBOALEN (maximum output area length)

field, AIB mask, 223AIBOAUSE (used output area length) field, AIB

mask, 223AIBREASN (reason code)

AIB mask, field, 223AIBREASN (reason code) field, AIB mask, 223AIBRSA1 (resource address) field, AIB mask,

223AIBRSNM1 (resource name) field, AIB mask,

222AIBSFUNC (subfunction code) field, AIB

mask, 222AIBTDLI interface, 218


Index 527

ALL type system definition, 332allocation

changes to processing, 390RECON data sets, of, 400specifications for RECON data sets, 398

analyzing requirements for data sharing, assign-ing a sharing level with DBRC, 393

API (application program interface)APPC/IMS

explicit, 186implicit, 186

OM, 497overview of IMS API, 235REXX SPOC, 497

Apollo space program, 3APPC (advanced program-to-program commu-

nication)/IMSAPI


APPC (Advanced Program-to-Program Com-munications)

editing and formatting, 297IMS support of, 47using in a sysplex, 478

APPC/IMSAPI


in a sysplex, 477LU 6.2 devices, 185

APPLCTN macro, 335application control block (ACB), generating,

230Application Group Name (AGN) exit routine

(DFSISIS0), 352application interface block (AIB)

AIBERRXT (reason code), 223AIBID (AIB identifier), 222AIBOALEN (maximum output area

length), 223AIBOAUSE (used output area length), 223AIBREASN (reason code), 223AIBRSA1 (resource address), 223AIBRSNM1 (resource name), 222AIBSFUNC (subfunction code), 222

DFSAIB allocated length (AIBLEN), 222introduction to, 218mask, 222, 223

application programmingdatabase calls, 235reporting, 415system service calls, 237

Application Programming IMS DB, 241Application Programming IMS TM, 281Application Programming Overview, 217application programs

AIB mask, 221callable interface (DL/I), 4calls to DL/I, 242calls to IMS, 227calls with command codes, 255characteristics

choosing, 291for IMS TM, 290system, 290terminal, 290

checkpoint (CHPK) calls, 277COBOL considerations, 261control blocks, 230conversational transaction, 284database processing, 241databases with logical relationships, pro-

cessing, 265databases with secondary indexes, process-

ing, 267DB PCB mask, 225delete calls, logical database, 266design for IMS DB, overview, 241design for IMS TM

3270-type screen, 293conversations, 293number of passes, 292overview of, 289transaction or program grouping, 293

DL/I (callable interface), 4elements of, 218entry point, 220get hold (GH) calls, 251

using a secondary index, 268get next (GN) calls, 249get unique (GU) calls, 248


528 Index

GSAM databases, processing, 260I/O area, 218insert (ISRT) calls

in a logical database, 266inserting segments, 254Java, 311JBP, building, 315JMP, building, 314JMP, example of, 314logical child, accessing, 265maintenance, 307message calls, 283message processing

for IMS TM, 281message switches, 285network role, 177output messages, 284PCB mask, 218PL/I considerations, 261processing

intent, 212traditional model, 18updated traditional model, 20

PSB, role of, 283records, processing, 246remote, 178replace calls

in a logical database, 265using a secondary index, 268

restart (XRST) call, 276restarting after failure, 275retrieve calls


sample call format, 246scheduling

BMP programs, 212Fast Path transactions, 212JBP programs, 212

segmentsaccessing in a logical database, 265accessing via a secondary index, 267deleting, 253retrieving, 248searching for, 243updating, 252

set up for, 230status code processing, 228structure, 218system service calls, 259terminated due to insufficient storage, 113terminating, 229, 285testing, 239TP PCB mask, 227transaction response time, 291update access to database, 120writing

for IMS DB, 241for IMS TM, 281overview of, 217

area (DEDB), 102ARM (automatic restart manager), 488ASSIGN (/ASSIGN) command

ETO, 423to modify regions, 422to modify static LTERMs, 423to modify terminals, 422to modify transactions, 422

automated operator programs, 497automatic restart manager (ARM), 488

B

backout, dynamic, 153BACKUP.RECON command, 401basic edit function

input messages, 308of data, 298output messages, 309overview of, 308SLU 1 transparent data, 309

Batch Backout utility (DFSBBO00), 163batch environment

connecting to DB2 UDB for z/OS, 35IMS DB, 33IMS TM, 35overview of, 33

BATCH type system definition, 332BINPDSB1= parameter, BINTRNDS option,

309block, definition of, 392


Index 529

block-level data sharingDBRC support of, 392method of data sharing, 116

BMP programsbacking out, 287message processing limit, 211scheduling, 212TP PCBs, 233

books, IMS, 13Buffer Size Specification facility (DSPBUFFS),

352buffers

and OSAM, 111DLISAS, used by, 36insufficient storage, 113moving data, 83reporting, 415

BUFPOOLS macro, 335Build Security Environmentexit routine

(DFSBSEX0), 352BUILDQ keyword, 420

C

callable servicesCANCEL function, 351DELETE module function, 351ENQUEUE function, 351FIND control block function, 351FREE storage function, 351GET storage function, 351how to use, 351INSERT function, 351LOAD module function, 351overview of, 350SCAN control block function, 351types, 350

callsapplication programming, 235

CANCEL function, 351CHANGE (/CHANGE) command, 424change accumulation

definition of, 146group, 383log data set, 158

records in RECON data set, 396change destination (CHNG) calls

for messages, 283CHANGE.PRILOG command

RECON log control records, changing, 383CHANGE.SECLOG command, 383characteristics, choosing for IMS TM applica-

tions, 291checkpoint (CHPK) calls, 259, 277checkpoint/restart

batch, 275IMS TM applications, 286

checkpoints, applicationbasic, 112introduction to, 111symbolic, 114

CHNG (change destination) callsfor messages, 283

CHPK (checkpoint) calls, 259, 277CICS

DBT (DBCTL thread), 31IMS Java function overview, 320subsystems supported, 15

class processing, for MPRs, 209class, transaction code, 207client communications

and IBM WebSphere Application Server for z/OS, 188

TCP/IP, 188Clob interface

retrieveXML, 321clones

definition of, 468COBOLSee Enterprise COBOL, 316cold start of IMS, 52COMM macro, 335Command Authorization exit routine

(DFSCCMD0), 352command codes in DL/I calls

D command code, 255F command code, 257hyphen command code, 257L command code, 257N command code, 257P command code, 256

command message, as input to IMS TM, 195

6202 Meltz.bk 29 Thursday, December 9, 2004 12:48 PM

530 Index

commands/ACTIVATE, 422/ASSIGN, 422

ETO, 423/CHANGE, 424/CHECKPOINT SNAPQ, 420/COMPT, 422/DBDUMP, 423/DBRECOVERY, 423/DEQUEUE, 422, 423/DISPLAY

for dead letter status, 423/ERESTART, 420/IDLE, 422/MSASSIGN, 424/MSVERIFY, 424/NRESTART, 420/RMGENJCL, 387/RMxxxxxx, 419/RSTART, 422/START, 53, 393/STOP, 424/TRACE, 406, 414, 416, 422BACKUP.RECON, 401CHANGE.PRILOG, 383CHANGE.SECLOG, 383CONV

/DISPLAY, 424DBRC log-related commands

CHANGE.PRILOG, 385CHANGE.RECON, 385CHANGE.SECLOG, 385DELETE.LOG, 385GENJCL.ARCHIVE, 385GENJCL.CLOSE, 385LIST.LOG, 385NOTIFY.PRILOG, 385NOTIFY.SECLOG, 385

effect on resources, 421for IMS TM, 171for multiple resources, 421GENJCL, 387GENJCL.ARCHIVE, 384INIT.RECON, 399terminals

/DISPLAY, 422

to modify regions/ASSIGN, 422

to modify transactions/ASSIGN, 422

TRACE CT, 416used with Database Recovery Control utili-

ty, 377Common Queue Server (CQS)

checkpoint data set, 204client

definition, 201exit routines, 205

definitions, 201introduction to, 40overview of, 205, 496shared queues environment, in a, 203

Common Service Layer (CSL)components of, 496introduction to, 41

communication controller, 177communications network

communications, 175components, 176IMS TM, overview, 175optional components, 179required components, 178SNA

overview of, 175communications, establishing, 194COMPT (/COMPT) command, 422concatenated keys

in DB PCB, 227CONFIG macro, 335conflicts when accessing segments, 287connections, distributing

sessions, 474socket, 474

consistent data, 111control blocks

ACB, 83, 230DBD, 83for hierarchical database structures, 83generating, 230MFS, 305PCB, 120PSB, 83, 230


Index 531

Control Center, IMS, 497control function, MFSSee MFS (Message For-

mat Service), 298control records

in RECON data set, 396control region

introduction to, 28conversation status, 424Conversational Abnormal Termination exit rou-

tine (DFSCONE0), 352conversational transactions, 284, 293, 315copying phase of HALDB Online Reorganiza-

tion, 146coupling facilities

definition, 201monitoring structures, 430recovery techniques in a sysplex, 490

CPI-C (Common Programming Interface for Communications), 185

CQS (Common Queue Server)checkpoint data set, 204client

definition, 201exit routines, 205

definitions, 201introduction to, 40overview of, 205, 496shared queues environment, in a, 203

CSL (Common Service Layer)components of, 496introduction to, 41

CTLBLKS type system definition, 332CTLUNIT macro, 335CTRACE service, 416cursor

cursor-active status for HALDB Online Re-organization, 146

HALDB Online Reorganization, 148customer strategy and IMS, 5customers of IMS, 5customizing IMS

changeable interfaces, 349control blocks, 349example of, 347introduction to, 347what can be customized, 348

D

D command code, 255DASD requirements, 14data (same) in IMS and DB2, 64Data Capture exit routine, 352data communications, 4Data Communications Control (DCCTL), 189Data Conversion User exit routine

(DFSDBUX1), 352data entry database (DEDB)

advantages and disadvantages, 105area, 102High Speed Sequential Processing (HSSP),

104implementing, 101independent overflow (IOVF) part, 102initializing, 103introduction to, 62multiple area data sets (MADS), 104optional features, 104root addressable part, 102shared VSO, 104structure of, 102VSO (Virtual Storage Option), 104when to choose, 106

Data Entry Database Randomizing routine (DBFHDC40/ DBFHDC44), 352

Data Entry Database Resource Name Hash rou-tine (DBFLHSH0), 352

Data Facility Storage Management Subsystem (DFSMS)

and logging, 373managing data sets, 109

Data Language/Interface (DL/I)application callable interface, 4

data propagation, 64data set group

definition of, 63data set, change accumulation log, 158Data Sharing, 119data sharing

and DBRC, 121assigning a sharing level with DBRC, 393controlling, 428database integrity, 394


532 Index

data-sharing records, 393DBRC, 431DBRC support of, 391how applications share, 120in a sysplex, 469information in the RECON data set, 393levels of

block level, 392database level, 392

levels of controlblock level, 119database level, 119

methodsblock-level data sharing, 116Parallel Sysplex data sharing, 116program isolation (PI), 116

non-sysplex, 119resources, monitoring, 429sysplex, 119update access, 120

data, locking, 114Database Change Accumulation utility

(DFSUCUM0)introduction to, 158

database descriptor block (DBD)generating, 230

Database Image Copy 2 utility (DFSUDMT0), 157

Database Image Copy utility (DFSUDMP0), 154

DATABASE macro, 335database models

hierarchical, 67relational, 68

database processingdirect access, 241sequential access, 241

database recordsin RECON data set, 396

Database Recovery, 151database recovery, 390Database Recovery Control (DBRC)

/RMxxxxxx commands, 419address space, 36API, 381assigning a sharing level, 393

batch commands, 380commands, 387communicating with, 379components of

Database Recovery Control utility (DSPURX00), 377

RECON data set, 377skeletal JCL, 378

data sets, defining recovery requirements, 387

partitioned, 378data sharing, 391database

backup, 385recovery, 385


database recovery, controlling, 387, 389, 394

functions of, 375, 381generating JCL, 378log control, 381overview of, 376partitioned data set members, 378RECON, defining recovery requirements,

387region, 36support of IMSplexes, 395support of RSR, 394tailoring JCL, 384tasks of, 376when to use, 378


Database Recovery utility (DFSURDB0), 161database types

DEDB, choosing, 106full-function, choosing

HDAM, 93HIDAM, 97HISAM, 108HSAM, 108PHDAM, 100PHIDAM, 100

introduction to, 83database, index


Index 533

PSINDEX (Partitioned Secondary Index database), 101

database-level data sharing, 392databases

access intent, 391access, stopping, 423accessed by multiple applications, 114, 115accessing, 436backup copies, 153DBRC's role in recovering, 385deadlocks, 115design, 83effect of commands on, 428full-function, introduction to, 63GSAM, 107GSAM, processing, 260hierarchical, 83initializing, 269integrity in data sharing, 394integrity, providing, 287loading, 269

HDAM, 270HIDAM, 270overview of, 269with logical relationships, 271with secondary indexes, 271

locking, 114log records, archiving, 384open exit, 390positioning, after calls, 258positioning, for calls, 247processing

with logical relationships, 265with secondary indexes, 267

program isolation, 287recovering, 384recovering, process overview, 152recovery, 421reorganizing, 126

DEDBs, offline, 141DEDBs, online, 144HALDBs, offline, 142HALDBs, online, 145introduction to, 123offline, 129offline utilities, 130

online, 144physical, 124proactive, 125process, overview of, 128purpose of, 124reactive, 125reloading, 133sample guidelines, 127structural, 124unloading, 132Utility Control Facility, using, 131when to reorganize, 124

stopping access to, 423utilities for recovery, 153

DB batch environment, 33DB batch programs, recovering, 153DB Monitor, 413DB PCB

generating, 231mask

concatenated keys, 227example of, 225

DB/DCintroduction to, 29

DB2 subsystems supported, 15DB2 UDB for z/OS

accessapplication programming, 317drivers, 317

connecting to IMS TM batch, 35stored procedures

accessing IMS, 319DBC (DBCTL control region), procedure, 43DBCTL

introduction to, 31thread, (DBT), 31

DBD (database descriptor block)generating, 230

DBDLIB, 230DBDS group records

in RECON data set, 396DBDUMP (/DBDUMP) command, 423DBFHAGU0 (Fast Path Input Edit/Routing exit

routine), 352DBFHDC40/ DBFHDC44 (Data Entry Database

Randomizing routine), 352


534 Index

DBFLHSH0 (Data Entry Database Resource Name Hash routine), 352

DBFULTA0 (Fast Path Log Analysis utility), 407

DBRC (Database Recovery Control)/RMxxxxxx commands, 419address space, 36API, 381assigning a sharing level, 393batch commands, 380commands, 387commands, overview, 377communicating with, 379components of


RECON data set, 377skeletal JCL, 378

controlling data sharing, 119data sets, defining recovery requirements,

387partitioned, 378

data sharing, 391, 431database

backup, 385recovery, 385


database recovery, controlling, 387, 389, 394

functions of, 375, 381generating JCL, 378log control, 381overview of, 376partitioned data set members, 378RECON, defining recovery requirements,

387recovery utilities, 389region, 36support of IMSplexes, 395support of RSR, 394tailoring JCL, 384tasks of, 376when to use, 378

DBRC (Database Recovery Control), procedure, 43

DBRC Command Authorization exit routine (DSPDCAX0), 352

DBRECOVERY (/DBRECOVERY) command, 423

DCC (DCCTL control region), procedure, 43DCCTL (Data Communications Control), 189

generation, 189IMS BTS, 189introduction to, 31procedures, 189TM batch, 189

ddname naming convention for reorganizing HALDBs online, 145

dead letter queue, 423deadlocks

and DB2 UDB for z/OS, 116and IMS, 115, 287

deallocation, changes to processing, 390DEDB (data entry database)

advantages and disadvantages, 105area, 102High Speed Sequential Processing (HSSP),

104implementing, 101independent overflow (IOVF) part, 102initializing, 103multiple area data sets (MADS), 104optional features, 104root addressable part, 102sequential dependent segment (SDEP) seg-

ment, 105shared VSO, 104structure of, 102VSO (Virtual Storage Option), 104when to choose, 106

definition process, macrosAPPLCTN, 335BUFPOOLS, 335COMM, 335CONFIG, 335CTLUNIT, 335DATABASE, 335FPCTRL, 335IDLIST, 335IMSCTF, 335IMSCTRL, 335


Index 535

IMSGEN, 335LINE, 335LINEGRP, 335MSGQUEUE, 335MSLINK, 335MSNAME, 335MSPLINK, 335NAME, 335POOL, 335RTCODE, 335SECURITY, 335STATION, 335TERMINAL, 335TRANSACT, 335TYPE, 335VTAMPOOL, 335

definition process, systemALL, 332BATCH, 332CTLBLKS, 332definition of, 329introduction to, 51JCLIN process, 334macros, 335MODBLKS, 332MSVERIFY, 332NUCLEUS, 332ON-LINE, 332overview of, 330running the SMU Maintenance utility, 334SMP/E maintenance, 334stage 1, 333stage 2, 333types of, 332

delete (DLET) callsin a logical database, 266introduction to, 235using, 253

DELETE module function, 351Dependent Region Preinitialization routines,

352dependent regions

adjusting processing load, 422batch message processing (BMP) region, 37definition of, 28Fast Path (IFP) region, 37

introduction to, 36Java batch processing (JBP) region, 37Java message processing (JMP) region, 37message processing region (MPR), 37starting, 53

DEQUEUE (/DEQUEUE) command, 422, 423descriptors

logon, 341MFS, 341MSC, 341user, 341

device input format (DIF), 306device output format (DOF), 305DFS29800 (2972/2980 Input edit routine), 352DFS36010 (4701 Transaction Input edit rou-

tine), 352DFSAOE00 (Type 2 Automated Operator exit

routine), 352DFSAOUE0 (Type 1 Automated Operator exit

routine), 352DFSBBO00 (Batch Backout utility), 163DFSBSEX0 (Build Security Environment exit

routine), 352DFSCCMD0 (Command Authorization exit rou-

tine), 352DFSCKWD0 (IMS Command Language Modi-

fication facility), 352DFSCMTU0 (User Message Table), 352DFSCMUX0 (Message Control/Error exit rou-

tine), 352DFSCNTE0 (Message Switching (Input) edit

routine), 352DFSCONE0 (Conversational Abnormal Termi-

nation exit routine), 352DFSCSGN0 (Sign On/Off Security exit routine),

352DFSCSMB0 (Transaction Code (Input) edit rou-

tine), 352DFSCTRN0 (Transaction Authorization exit

routine), 352DFSCTSE0 (Security Reverification exit rou-

tine), 352DFSCTTO0 (Physical Terminal Output edit rou-

tine), 352DFSDBUX1 (Data Conversion User exit rou-

tine), 352


536 Index

DFSDDLT0 (DL/I test program), 239DFSERA10 (File Select and Formatting Print

utility), 406DFSFDOT0 (Dump Override Table), 352DFSFEBJ0 (Front-End Switch exit routine), 352DFSFIDN0 (ESAF Indoubt Notification exit

routine), 352DFSFLGX0 (Logger exit routine), 352DFSFTFX0 (Log Filter exit routine), 352DFSGMSG0 (Greeting Messages exit routine),

352DFSGPIX0 (Global Physical Terminal (Input)

edit routine), 352DFSHDC40 (HDAM and PHDAM Randomiz-

ing routines), 352DFSILTA0 (Log Transaction Analysis utility),

407DFSINSX0 (Output Creation exit routine), 352DFSINTX0 (Initialization exit routine), 352DFSIRP0 (Program Isolation Trace Report utili-

ty), 416DFSISIS0 (Application Group Name (AGN)

exit routine), 352DFSISTS0 (Statistical Analysis utility), 408DFSJBP (Java batch processing region), proce-

dure, 43DFSJMP (Java message processing region), pro-

cedure, 43DFSKBLA3 (Knowledge-Based Basic Format-

ting Print routine), 408DFSKBLAK (Knowledge-Based Formatting

Print routine), 408DFSKBLAS (Knowledge-Based Summary For-

matting Print routine), 408DFSLGFX0 (Logoff exit routine), 352DFSLGNX0 (Logon exit routine), 352DFSLUEE0 (LU 6.2 Edit exit routine), 352DFSME000 (Input Message Field edit routine),

352DFSME127 (Input Message Segment edit rou-

tine), 352DFSMPR (message processing region), proce-

dure, 43DFSMS (Data Facility Storage Management

Subsystem)and logging, 373

managing data sets, 109DFSMSCE0 (TM and MSC Message Routing

and Control User exit routine), 352DFSNDMX0 (Non-Discardable Messages exit

routine), 352DFSPIXT0 (Physical Terminal Input edit rou-

tine), 352DFSPPUE0 (Partner Product exit routine), 352DFSPRE60 (System Definition Preprocessor

exit routine - Input Phase), 352DFSPRE70 (System Definition Preprocessor

exit routine - Name Check Complete), 352

DFSPSE00 (HALDB Partition Selection exit routine), 352

DFSQSPC0/DFSQSSP0 (Queue Space Notifi-cation exit routine), 352

DFSRAS00 (Resource Access Security exit rou-tine), 352

DFSREXXU (IMS Adapter for REXX exit rou-tine), 352

DFSSGFX0 (Signoff exit routine), 352DFSSGNX0 (Sign-On exit routine), 352DFSSIML0 (Shared Printer exit routine), 352DFSSS050 (Large SYSGEN Sort/Split Input

exit routine), 352DFSSTAT (//DFSSTAT) reports, 415DFSTXIT0 (Time-Controlled Operations (TCO)

exit routine), 352DFSUARC0 (Log Archive utility)

description of, 383DFSUCF00 (Utility Control Facility), 131DFSUCUM0 (Database Change Accumulation

utility)introduction to, 158

DFSUDMP0 (Database Image Copy utility), 154

DFSUDMT0 (Database Image Copy 2 utility), 157

DFSUICP0 (Online Database Image Copy utili-ty), 157

DFSUPAA0 (MFS Language utility), 300DFSURDB0 (Database Recovery utility), 161DFSUTSA0 (MFS Service utility), 300DFSYDRU0 (OTMA Destination Resolution

exit routine), 352


Index 537

DFSYIOE0 (OTMA Input/Output Edit exit rou-tine), 352

DFSYPRX0 (OTMA Prerouting exit routine), 352

DIF (device input format), 306direct-access storage device requirements, 14DISPLAY (/DISPLAY) command

CONV, 424for dead letter status, 423terminals, 422

distributingconnection requests from a Web server, 479logons automatically, 475logons manually, 475sessions, 474sockets, 474sockets across multiple target systems, 480transaction workload, 474transactions in a sysplex

overview of, 480using MSC, 482using shared queues, 483

DL/Iapplication callable interface, 4binding, 349calls

delete (DLET), 253for messages, 283get hold (GH), 251get next (GN), 249get unique (GU), 248insert (ISRT), 254with command codes, 255

exit routine, writing, 349separate address space, 36

DL/I test program (DFSDDLT0)overview, 239

DLET (delete) calls, 253DLIBATCH (DB batch region), procedure, 43DLIModel utility

inputs and outputs, 312metadata classes, creating, 312overview, 312

DLISAS (DL/I separate address space region), procedure, 43

DNS/WLM (Domain Name Server/Workload

Manager), 478documentation, IMS, 13DOF (device output format), 305Domain Name Server/Workload Manager

(DNS/WLM), 478DSPBUFFS (Buffer Size Specification facility),

352DSPCEXT0 (RECON I/O exit routine), 352DSPDCAX0 (DBRC Command Authorization

exit routine), 352DSPSCIX0 (SCI Registration exit routine), 352DSPURX00 (Database Recovery Control utili-

ty), 377dump

message queues, 420DXRJPROC (IRLM region), procedure, 43dynamic backout, 153dynamic definition of terminals, 338dynamic terminal, 339dynamic terminals, 181dynamic user, 339

E

Editing and Formatting Messages, 297editing messages, 308emergency restart

/ERE command, 420for IMS TM applications, 287introduction to, 52

EMH (expedited message handler), 38ENQUEUE function, 351Enterprise COBOL

back end, 316front end, 316object oriented syntax, 316

entry pointoverview, 220

entry-sequenced data sets (ESDSs), 109environments

batchIMS DB, 33IMS TM, 35introduction to, 33

DB/DC, 29


538 Index

DBCTL, 31DCCTL, 31IMS, 29region supported in, 37

ERESTART (/ERESTART) command, 420ESAF Indoubt Notification exit routine

(DFSFIDN0), 352ESDSs (entry-sequenced data sets), 109establishing a session, 194ETO (Extended Terminal Option)

descriptorslogon, 341MFS, 341MSC, 341user, 341

descriptors and exit routines, 344dynamic terminals, 181, 339dynamic user, 339overview of, 338RACF, 182SMU, nonsupport of, 182static terminal, 339structures, creating, 343terminal structure, 339terminology, 339user assignments, 423user structure, 339

event logging, introduction to, 54events, system-level tracing, 415execution members, JCL, 378exit routines

2972/2980 Input edit routine, 3524701 Transaction Input edit routine, 352Application Group Name (AGN) exit rou-

tine, 352binding, 349Buffer Size Specification Facility, 352Build Security Environment exit routine,

352Command Authorization exit routine, 352Conversational Abnormal Termination exit

routine, 352Data Capture exit routine, 352Data Conversion User exit routine, 352Data Entry Database Randomizing routine,

352

Data Entry Database Resource Name Hash routine, 352

Data Entry Database Sequential Dependent Scan Utility exit routine, 352

DBRC Command Authorization exit rou-tine, 352

Dependent Region Preinitialization routine, 352

ESAF Indoubt Notification exit routine, 352

Fast Path Input Edit/Routing exit routine, 352

for customizing IMS, 347Front-End Switch exit routine, 352Global Physical Terminal (Input) edit rou-

tine, 352Greeting Messages exit routinee, 352HALDB Partition Selection exit routine,

352HDAM and PHDAM Randomizing rou-

tines, 352IMS Adapter for REXX exit routine, 352IMS Command Language Modification fa-

cility, 352Initialization exit routine, 352Input Message Field edit routine, 352Input Message Segment edit routine, 352Large SYSGEN Sort/Split Input exit rou-

tine, 352Log Archive exit routine, 352Log Filter exit routine, 352Logger exit routine, 352Logoff exit routine, 352Logon exit routine, 352LU 6.2 Edit exit routine, 352Message Control/Error exit routine, 352Message Switching (Input) edit routine, 352Non-Discardable Messages exit routine,

352OTMA Destination Resolution exit routine,

352OTMA Input/Output Edit exit routine, 352OTMA Prerouting Exit Routine, 352Output Creation Exit Routine, 352Partner Product exit routine, 352performance considerations, 351


Index 539

Physical Terminal Input edit routine, 352Physical Terminal Output edit routine, 352Queue Space Notification exit routine, 352RECON I/O exit routine, 352Resource Access Security exit routine, 352SCI Registration exit routine, 352Secondary Index Database Maintenance

exit routine, 352Security Reverification exit routine, 352Segment Edit/Compression exit routine,

352Sequential Buffering Initialization exit rou-

tine, 352Shared Printer exit routine, 352Sign On/Off Security exit routine, 352Signoff exit routine, 352Sign-On exit routine, 352standard user exit interface, 349summary of, 352System Definition Preprocessor exit routine

(Input Phase), 352System Definition Preprocessor exit routine

(Name Check Complete), 352Time-Controlled Operations (TCO) exit

routine, 352TM and MSC Message Routing and Con-

trol User exit routine, 352Transaction Authorization exit routine, 352Transaction Code (Input) edit routine, 352Type 1 Automated Operator exit routine,

352Type 2 Automated Operator exit routine,

352User Message Table, 352VTAM USERVAR, 475

expedited message handler (EMH), 38Extended Recovery Facility (XRF)

introduction to, 55overview of, 440

Extended Terminal Option (ETO)descriptors

logon, 341MFS, 341MSC, 341user, 341

descriptors and exit routines, 344

dynamic terminals, 181, 339dynamic user, 339overview of, 338RACF, 182reduction of time of system definition, 182SMU, nonsupport of, 182static terminal, 339structures, creating, 343terminal structure, 339terminology, 339user structure, 339

F

F command code, 257Fast Database Recovery (FDBR)


Fast Pathintroduction to, 64messages, 182overview, 182registering databases and DEDB areas, 393transactions

scheduling, 212Fast Path Input Edit/Routing exit routine

(DBFHAGU0), 352Fast Path Log Analysis utility (DBFULTA0),

407FDBR (Fast Database Recovery)


fieldscolumns, compared to, 68sequence, 73

File Select and Formatting Print utility (DFSERA10), 406

FIND control block function, 351flow, transaction, 173format

for records, 261formatting

OLDS, 433FPCTRL macro, 335FPUTIL (Fast Path utility region), procedure, 43


540 Index

free spaceHDAM (Hierarchical Direct Access Meth-

od), 91FREE storage function, 351Front-End Switch exit routine (DFSFEBJ0), 352full-function databases

HDAM, 89HIDAM, 94introduction to, 63PHDAM, 97PHIDAM, 97

G

generalized sequential access method (GSAM)databases, processing, 260introduction to, 107

GENJCL command, 387GENJCL.ARCHIVE command, 384get hold (GH) calls

introduction to, 235, 251using a secondary index, 268

get hold next (GHN) callsintroduction to, 235

get hold unique (GHU) callsintroduction to, 235

get next (GN) calls, 249for messages, 283introduction to, 235qualified, 250unqualified, 249

GET storage function, 351get unique (GU) calls

for messages, 283introduction to, 235overview of, 248

Global Physical Terminal (Input) edit routine (DFSGPIX0), 352

GN (get next) calls, 249for messages, 283qualified, 250unqualified, 249

Greeting Messages exit routine (DFSGMSG0), 352

GSAM (generalized sequential access method)

databases, processing, 260introduction to, 107

GSAM databases, processing, 260GTF (generalized trace facility) trace, 415GU (get unique) calls

for messages, 283overview of, 248

H

HALDB Online Reorganizationcopying phase, 146cursor, 148cursor-active status, 146ddname naming conventions, 145initialization phase, 146overview, 145termination phase, 148unit of reorganization, 148

HALDB Partition Selection exit routine (DFSPSE00), 352

HALDBs (High Availability Large Databases)indirect list data set (ILDS), 97introduction to, 88offline reorganization, 142online reorganization, 145partitions, naming conventions, 99reorganizing

offline, 142online, 145secondary indexes, 142

self-healing pointers, 97HDAM (Hierarchical Direct Access Method)

advantages and disadvantages, 92free space, 91layout of, 89overflow area, 89overview of, 89root addressable area, 89when to choose, 93z/OS access methods used, 98

HDAM and PHDAM Randomizing routines (DFSHDC40), 352

HIDAM (Hierarchical Indexed Direct Access Method)


Index 541

advantages and disadvantages, 96index database, 98layout of, 94, 96overview of, 94when to choose, 97

Hierarchical DatabasesImplementing, 83

hierarchical databasescontrol blocks, 83data entry database (DEDB), 101data structure, 70Hierarchical Direct Access Method

(HDAM), 89Hierarchical Indexed Direct Access Method

(HIDAM), 94model, implementing, 83overview of, 67Partitioned Hierarchical Direct Access

Method (PHDAM), 97Partitioned Hierarchical Indexed Direct Ac-

cess Method (PHIDAM), 97relational database, compared to, 68types, introduction to, 87

Hierarchical Direct Access Method (HDAM)advantages and disadvantages, 92free space, 91layout of, 89overflow area, 89overview of, 89root addressable area, 89when to choose, 93z/OS access methods used, 98

Hierarchical Indexed Direct Access Method (HIDAM)

advantages and disadvantages, 96index database, 98layout of, 94, 96overview of, 94when to choose, 97

Hierarchical Indexed Sequential Access Method (HISAM), 108

Hierarchical Sequential Access Method (HSAM), 108

High Speed Sequential Processing (HSSP), 104HISAM (Hierarchical Indexed Sequential Ac-

cess Method), 108

history of IMS, 3HSAM (Hierarchical Sequential Access Meth-

od), 108hyphen command code, 257

I

IBM strategy and IMS, 7IDLE (/IDLE) command, 422IDLIST macro, 335ILDS (Indirect List Data Set)

Index/ILDS Rebuild Utility (DFSPREC0), 389

image copiesconsistent, 157fuzzy, 157

IMS (DB/DC control region), procedure, 43IMS (IBM) tools

application management, 447database administration, 443information integration management, 455miscellaneous, 463performance management, 450recovery management, 452TM management, 461utilities management, 456

IMS Adapter for REXX exit routine (DFSR-EXXU), 352

IMS Callable ServicesSee callable services, 350

IMS Command Language Modification facility (DFSCKWD0), 352

IMS Connectintroduction to, 187multiple instances of in sysplex, 480

IMS Control Center, 497IMS Database ManagerSee IMS DB, 61IMS DB

application programming, 241customizing, 347data sharing, 119database reorganizing, 123environments, 29, 31, 33functions of, 61hierarchical database model, 67


542 Index

history of, 3interfaces to, 22introduction to, 9overview of, 61sysplex, in a, 469types of databases

data entry database (DEDB), 62Fast Path, 62full-function, 62introduction to, 62main storage database (MSDB), 62

IMS DB exit routinesData Capture exit routine, 352Data Conversion User exit routine, 352Data Entry Database Randomizing routine,

352Data Entry Database Resource Name Hash

routine, 352Data Entry Database Sequential Dependent

Scan Utility exit routine, 352HALDB Partition Selection exit routine,

352HDAM and PHDAM Randomizing rou-

tines, 352Secondary Index Database Maintenance

exit routine, 352Segment Edit/Compression exit routine,

352Sequential Buffering Initialization exit rou-

tine, 352summary of, 352

IMS Java functiondependent regions, 39DLIModel utility, 312JDBC support, 311overview of, 20remote database services

about, 318supported environments, 20

IMS Java hierarchical database interfaceabout, 311

IMS Monitor, 413, 414, 415IMS recovery utilities, 389IMS relationship to z/OS, 27IMS TM

accessing in a sysplex, 478

APPC-driven transactionsand message queues, 200

application programming for, 281application programs, designing, 289control region, 170customizing, 347DC Control environment, 189designing application programs, 289environments, 29, 31, 35establishing a session, 194flow, transaction, 173history of, 4input message origin, 197input message types, 195interfaces to, 24introduction to, 9master terminal operator (MTO), 190message queues, 198

Fast Path, 200size and performance, 198

message scheduling, 206message types, 171messages, editing and formatting, 297network

component role, 177optional components, 179overview, 175required components, 178

operating the network, 190with APPC/IMS, 194

optional componentsExtended Terminal Option (ETO), 181IMS Connect, 187

OTMA-driven transactionsand message queues, 200

overview of, 12, 169processing input, 195services

APPC/IMS, 185Extended Terminal Option (ETO), 181Fast Path, 182Intersystem Communication (ISC),

183Message Format Service (MFS), 182Multiple Systems Coupling (MSC),

183


Index 543

Open Transaction Manager Access (OTMA), 179

sysplex, in a, 474terminal input destination, 197terminal types, 197transaction flow, 173transaction scheduling, 208

IMS TM exit routines2972/2980 Input edit routine, 3524701 Transaction Input edit routine, 352Build Security Environment exit routine,

352Conversational Abnormal Termination exit

routine, 352Fast Path Input Edit/Routing exit routine,

352Front-End Switch exit routine, 352Global Physical Terminal (Input) edit rou-

tine, 352Greeting Messages exit routinee, 352IMS Adapter for REXX exit routine, 352Initialization exit routine, 352Input Message Field edit routine, 352Input Message Segment edit routine, 352Logoff exit routine, 352Logon exit routine, 352LU 6.2 Edit exit routine, 352Message Control/Error exit routine, 352Message Switching (Input) edit routine, 352Non-Discardable Messages exit routine,

352OTMA Destination Resolution exit routine,

352OTMA Input/Output Edit exit routine, 352OTMA Prerouting Exit Routine, 352Output Creation Exit Routine, 352Physical Terminal Input edit routine, 352Physical Terminal Output edit routine, 352Queue Space Notification exit routine, 352Security Reverification exit routine, 352Shared Printer exit routine, 352Sign On/Off Security exit routine, 352Signoff exit routine, 352Sign-On exit routine, 352Time-Controlled Operations (TCO) exit

routine, 352

TM and MSC Message Routing and Con-trol User exit routine, 352

Transaction Authorization exit routine, 352Transaction Code (Input) edit routine, 352Type 1 Automated Operator exit routine,

352IMS TM Overview, 169IMS TM Processing Input, 195IMS Transaction ManagerSee IMS TM, 169IMS utilities, introduction to, 54IMS Version 9

CICS subsystems supported, 15DB2 subsystems supported, 15hardware required for, 14language, written in, 15languages supported, 16software required for, 14

IMS.FORMAT, output from MFS, 300IMS.PROCLIB, 378IMS.SDFSISRC, 378IMS/360, 4IMSBATCH (IMS batch message processing re-

gion), procedure, 43IMSCTF macro, 335IMSCTRL macro, 335IMSFP (IMS Fast Path (IFP) region), procedure,

43IMSGEN macro, 335IMSplex

Common Queue Server (CQS), 496Common Service Layer (CSL), 496components of, 496DBRC support of, 395definition of, 495introduction to, 201operating, 499Operations Manager (OM), 497requirements for, 498Resource Manager (RM), 498Structured Call Interface (SCI), 498typical configuration, 496

IMSRDR (IMS JCL reader region), procedure, 43

IND (Interactive Network Dispatcher), 479index database

HIDAM and PHIDAM, 101


544 Index

PSINDEX (Partitioned Secondary Index database), 101

index databasesdeleting segments in, 268example of, 80inserting segments in, 269introduction to, 77segments, replacing in a, 268

Index/ILDS Rebuild utility (DFSPREC0), 389indexes, secondary

creating, 269indirect list data set, 97industries supported, 5information, sources of, 13INIT.RECON

commands, 399Initialization exit routine (DFSINTX0), 352initialization phase of HALDB Online Reorgani-

zation, 146Input Message Field edit routine (DFSME000),

352input message origin, 197Input Message Segment edit routine

(DFSME127), 352input message types

command message, 195message switch, 195transaction message, 195

insert (ISRT) callsadding segments, 254for messages, 283in a logical database, 266introduction to, 235

INSERT function, 351installing IMS

Installation Verification Program (IVP), 50introduction to, 49security, introduction to, 51system definition, introduction to, 51using SMP/E, 50

intent, processing, 212Interactive Network Dispatcher (IND), 479interfaces

AIBTDLI, 218CEETDLI, 220DL/I, 17

JDBC, 17to IMS, 17

IRLM (internal resource lock manager)data sharing, 394database integrity, 394monitoring, 428region, 43tracing, 416

ISC (Intersystem Communication)overview, 184users, assigning, 423

ISRT (insert) callsadding segments, 254for messages, 283

J

Java batch processing (JBP) applicationsbuilding, 315example, 315restart, 315symbolic checkpoint, 315

Java batch processing (JBP) regionsDB2 UDB for z/OS access

application programming, 317description, 39

Java message processing (JMP) regionsDB2 UDB for z/OS access


java.sql.ClobSee Clob interface, 321JBP (Java batch processing) applications

building, 315example, 315restart, 315symbolic checkpoint, 315

JBP (Java batch processing) regionsDB2 UDB for z/OS access


JBP programsscheduling, 212

JCL (job control language)generated by DBRC, 378skeletal execution members explained, 378


Index 545

tailoring for utilities, 384JCLIN process of system definition, 334JDBC

interface, 17JDBC, supported SQL keywords, 313JMP (Java message processing) regions

DB2 UDB for z/OS accessapplication programming, 317

description, 39JMP application

building, 314example of, 314

JMP applicationsmessage handling

conversational transactions, 315JOBJCL, skeletal JCL execution member, 378

K

key-sequenced data sets (KSDSs), 109Knowledge-Based Basic Formatting Print rou-

tine (DFSKBLA3), 408Knowledge-Based Formatting Print routine

(DFSKBLAK), 408Knowledge-Based Log Analysis (KBLA) utili-

ties, 408Knowledge-Based Summary Formatting Print

routine (DFSKBLAS), 408KSDSs (key-sequenced data sets), 109

L

L command code, 257Large SYSGEN Sort/Split Input exit routine

(DFSSS050), 352level of sharing definitions, 393libraries, online change, 300LINE macro, 335LINEGRP macro, 335list structures, definitions, 203LOAD module function, 351lock manager, internal resource lock manager

(IRLM), 43locked records from failed IMS, 472log

controlling the characteristics of, 431records

printing, 406reports, 408

system utilities, 406Log Archive exit routine, 352Log Archive utility (DFSUARC0)

description of, 383log control

valid API requestsLog query, 385OLDS query, 385

valid commandsCHANGE.PRILOG, 385CHANGE.RECON, 385CHANGE.SECLOG, 385DELETE.LOG, 385GENJCL.ARCHIVE, 385GENJCL.CLOSE, 385LIST.LOG, 385NOTIFY.PRILOG, 385NOTIFY.SECLOG, 385

Log Filter exit routine (DFSFTFX0), 352log records

in RECON data set, 396Log Transaction Analysis utility (DFSILTA0),

407Logger exit routine (DFSFLGX0), 352Logging, 367logging

data sets and DFSMS, 373during program processing, 286log components

list of, 368log buffers, 368OLDSs, 369RLDSs, 373SLDSs, 372WADSs, 371

off, definition, 476on, definition, 476overview of, 367system checkpoints, 367

logging IMS eventsintroduction to, 54

logical child


546 Index

accessing, 265logical databases

introduction to, 74logical links

effect of commands on, 426verifying path consistency, 424

logical partition (LPAR)and ARM, 488and WebSphere Application Server for z/

OS, 317logical relationships

introduction to, 74loading a database with, 271

logical terminals (LTERMs)effect of commands on, 426ETO, 182introduction to, 197

logical unitdefinition, 170programmable, definition, 176

Logical Unit type 6.2, 47Logoff exit routine (DFSLGFX0), 352Logon exit routine (DFSLGNX0), 352logons

distributing automatically, 475distributing manually, 475using a VTAM USERVAR exit, 475using VTAM Generic Resources, 475

LPAR (logical partition)and ARM, 488and WebSphere Application Server for z/

OS, 317LTERM

static user assignment, 423LTERMs (logical terminals)

effect of commands on, 426ETO, 182introduction to, 197

LU 6.2 Edit exit routine (DFSLUEE0), 352LU2 (3270) connections

in a sysplex, 478

M

macros

APPLCTN, 335BUFPOOLS, 335COMM, 335CONFIG, 335CTLUNIT, 335DATABASE, 335for customizing IMS, 347FPCTRL, 335IDLIST, 335IMSCTF, 335IMSCTRL, 335IMSGEN, 335LINE, 335LINEGRP, 335MSGQUEUE, 335MSLINK, 335MSNAME, 335MSPLINK, 335NAME, 335POOL, 335RTCODE, 335SECURITY, 335STATION, 335TERMINAL, 335TRANSACT, 335TYPE, 335VTAMPOOL, 335

maintenanceapplication programs, 307SMP/E, 334

master terminaland z/OS, 193introduction to, 190primary master, 192secondary master, 193

master terminal operator (MTO)commands, 191introduction to, 190tasks, 190

messageediting performed by IMS, 309

Message Control/Error exit routine (DFSCMUX0), 352

Message Format Service (MFS)administration, 304advantages, 307


Index 547

components, overview, 300description, 182input messages, 298introduction to, 297Language utility (DFSUPAA0), 300libraries, online change, 300message editor, 300naming conventions, 304online performance, 308output messages

bypass option effect, 299how MFS defines, 298

overview, 298pool manager, 300Service utility (DFSUTSA0), 300

message input descriptor (MID), 306message output descriptor (MOD)See MOD,

305message processing

for IMS TM, 281message processing region (MPR)

class processing, 209introduction to, 37

message queuesAPPC-driven transactions, 200creating a dump of, 420Fast Path, 200OTMA-driven transactions, 200overview, 198recovery, 420size and performance, 198

message switch, 195, 285Message Switching (Input) edit routine

(DFSCNTE0), 352messages

handling by IMS, 202queues, using Queue Control Facility, 420scheduling, 206SPA, 315

MFS (Message Format Service)administration, 304advantages, 307components, overview, 300description, 182input messages, 298Language utility (DFSUPAA0), 300

libraries, online change, 300message editor, 300naming conventions, 304online performance, 308output messages

bypass option effect, 299how MFS defines, 298

overview, 298pool manager, 300Service utility (DFSUTSA0), 300

MFS Language utility (DFSUPAA0), 300MFS Service utility (DFSUTSA0), 300MFSTEST procedure, 300MID (message input descriptor), 306MNPSs (multinode persistent sessions), 485MOD (message output descriptor)

purpose, 305MODBLKS type system definition, 332module, randomizing, 90, 98monitoring

IMS, 405IMS Monitor, 414IRLM activity, 428structure, 430system, 428

MSASSIGN (/MSASSIGN) command, 424MSC (Multiple Systems Coupling)

assignment, 424overview of, 183routing messages in a sysplex, 482

MSGQUEUE macro, 335MSLINK macro, 335MSNAME

verifying consistency, 424MSNAME macro, 335MSPLINK macro, 335MSVERIFY (/MSVERIFY) command, 424MSVERIFY type system definition, 332MTO (master terminal operator)

commands, 191introduction to, 190tasks, 190

multinode persistent sessions (MNPSs), 485multiple area data sets (MADS), 104multiple IMS systems

on a single z/OS image, 45


548 Index

on multiple z/OS images, 45running, 44working together, 495

Multiple Systems Coupling (MSC)assignment, 424overview of, 183routing messages in a sysplex, 482

N

N command code, 257NAME macro, 335naming conventions

HALDB Online Reorganization, ddname, 145

Message Format Service (MFS), 304NASA, 3NCP (Network Control Program), 177network

APPC/IMS, operating with, 194communications, 175ID, deleting, 424IMS TM, overview, 175operating

establishing communication, 190optional components, 179required components, 178SNA

overview of, 175node name, 197non-conversational transactions, 293Non-Discardable Messages exit routine

(DFSNDMX0), 352normal restart of IMS

introduction to, 52NRESTART (/NRESTART) command, 420NUCLEUS type system definition, 332

O

OLDS (online log data set)archiving, 421archiving with DBRC, 383buffer, changing, 431changing characteristics of, 431

location, changing, 431mode, changing, 431newly initialized volumes, 433volume, formatting, 433

OM (Operations Manager)API, 497IMS Control Center, 497introduction to, 42overview of, 497REXX SPOC API, 497TSO SPOC, 497

on demand infrastructure, IMS in a, 7online change

libraries, 300Online Database Image Copy utility

(DFSUICP0), 157online log data set (OLDS)

archiving, 384, 421online log data sets (OLDS)

archiving with DBRC, 383online performance, 308online reorganization

DEDBs, of, 144HALDBs, of, 145overview of, 144

online transaction conceptsapplication characteristics, 290system characteristics, 290terminal characteristics, 290

ON-LINE type system definition, 332operating IMS

//DFSSTAT reports, 415choosing monitoring tools, 413controlling data sharing, 428IMS Monitor, 414monitoring IMS, 405processing system logs, 406recovering

archiving OLDS, 421connecting subsystems, 436creating a dump of message queues,

420disconnecting subsystems, 436message queues, 420modifying log data sets, 431tasks, 419


Index 549

tuning log data sets, 431using DBRC commands, 419using utilities for, 421

tasks, list of, 405tracing

IMS trace facility, 418program isolation and lock, 416z/OS component trace service, 416z/OS generalized trace facility, 415

Operations Manager (OM)API, 497IMS Control Center, 497introduction to, 42overview of, 497REXX SPOC API, 497TSO SPOC, 497

OSAM (Overflow Sequential Access Method)for data set groups, 111IMS's use of, 109introduction to, 63storage limits, 111

OTMA Destination Resolution exit routine (DFSYDRU0), 352

OTMA Input/Output Edit exit routine (DFSYIOE0), 352

OTMA Prerouting exit routine (DFSYPRX0), 352

Output Creation exit routine (DFSINSX0), 352Overflow Sequential Access Method (OSAM)

for data set groups, 111IMS's use of, 109introduction to, 63storage limits, 111

P

P command code, 256Parallel Sysplex

accessing IMS TM, 478bringing IMS into, 469cloned systems, 468components of, 467data sharing, 469definition of, 467dependent regions in, 471

distributing transactions, 480using MSC, 482using shared queues, 483

failure recoverycoupling facilities, 490using ARM, 488using multiple servers, 488using structure duplexing, 491using structure rebuild, 490

Fast Database Recovery (FDBR), 471goals of, 468IMS DB in the, 469IMS groups, 471IMS TM, 474

summary of usage, 485introduction to, 467Rapid Network Reconnect (RNR), 485relationship to IMS, 48restrictions for data sharing, 470using IMS Connect, 479VTAM Generic Resources, 476

parentage, definition of, 256partitioned HDAM databases (PHDAM)

introduction to, 97when to choose, 100z/OS access methods used, 98

partitioned HIDAM databases (PHIDAM)index database, 98introduction to, 97when to choose, 100

partitionsnaming conventions, 99

Partner Product exit routine (DFSPPUE0), 352password, 424PCBs (program communication blocks)

and data sharing, 120DB PCB, 218mask, description, 223TP PCB, 218using multiple for one database, 259

PDS members, 378performance, of exit routines, 351PHDAM (Partitioned Hierarchical Direct Ac-

cess Method)database, reorganizing, 128introduction to, 97


550 Index

when to choose, 100z/OS access methods used, 98

PHIDAM (Partitioned Hierarchical Indexed Di-rect Access Method)

database, reorganizing, 128index database, 98introduction to, 97when to choose, 100

Physical Terminal Input edit routine (DFSPIXT0), 352

Physical Terminal Output edit routine (DFSCTTO0), 352

PI keyword, 416pointers, self-healing, 97POOL macro, 335procedures

DBC (DBCTL control region), 43DBRC (Database Recovery Control), 43DCC (DCCTL control region), 43DFSJBP (Java batch processing region), 43DFSJMP (Java message processing region),

43DFSMPR (message processing region), 43DLIBATCH (DB batch region), 43DLISAS (DL/I separate address space re-

gion), 43DXRJPROC (IRLM region), 43for customizing IMS, 347FPUTIL (Fast Path utility region), 43IMS (DB/DC control region), 43IMSBATCH (IMS batch message process-

ing region ), 43IMSFP (IMS Fast Path (IFP) region), 43IMSRDR (IMS JCL reader region), 43to run IMS, 43

processing intent, 212processing load

adjusting, 422processor requirements, 14program communication blocks (PCBs)

and data sharing, 120DB PCB, 218mask, description, 223TP PCB, 218using multiple for one database, 259

program isolation (PI)

method of data sharing, 116overview of, 287

Program Isolation Trace Report utility (DFSRIRP0), 416

program specification blocks (PSBs), 230, 283programming languages supported, 16PSBLIB, 230PSBs (program specification blocks), 230, 283PSINDEX

DDNAME requirements, 99PSINDEX (Partitioned Secondary Index data-

base), 101PSINDEX database, reorganizing, 128

Q

Queue Control Facility (QCF), 420Queue Space Notification exit routine

(DFSQSPC0/DFSQSSP0), 352queues, message

APPC-driven transactions, 200Fast Path, 200OTMA-driven transactions, 200overview, 198size and performance, 198

queues, sharedSee shared queues, 201

R

RACF (Resource Access Control Facility)data space, reinitializing, 424ETO security, 182introduction to, 47

randomizing module, 90, 98Rapid Network Reconnect (RNR), 485RECON data sets

adding a spare, 435and IMS systems, 397changing log control records, 383changing the characteristics of, 435creating, 398data sharing information in, 393DBD names in, 398defining, 398defining requirements in, 387


Index 551

description of, 395maintaining, 401making backups, 401placement considerations, 399recommendations for, 404recreating, 404removing a spare, 435reorganizing, 403replacing active, 435retrieving log-related information from, 385types of records in, 396

RECON data setssinitializing, 399

RECON I/O exit routine (DSPCEXT0), 352RECON initialization token (RIT), 390record

formats, 261record log information, 381RECOVER commands, 389recovering

databases, process overview, 152DB batch programs, 153transactions, 153

recovering the IMS systemoverview of, 439using RSR, 440using XRF, 440

recoveryconcepts, 152database, making recoverable, 421executing related functions, 419Extended Recovery Facility (XRF), 55IMS, introduction to, 55message queues, 420point-in-time, 385process overview, 152Remote Site Recovery (RSR), 55RSR (Remote Site Recovery), 55time stamp, 385utilities, 421XRF (Extended Recovery Facility), 55

recovery functions for DBDSs, 381recovery utilities, 389regions

assignment, 422class, 422

Common Queue Server (CQS), 40control, 28DBRC, 36dependent

application, 36batch message processing (BMP), 38DBCTL thread (DBT), 37Fast Path (IFP), 38introduction to, 36Java batch processing (JBP), 39Java message processing (JMP), 39message processing region (MPR), 37

DLISAS, 36generating, 43IMS TM control, 170internal resource lock manager (IRLM), 43introduction to, 28IRLM (internal resource lock manager), 43Operations Manager (OM), 42Resource Manager (RM), 42SCI (Structured Call Interface), 42separate address spaces

DBRC, 36DL/I, 36

starting, 53Structured Call Interface (SCI), 42

registerssaving, 350

Remote Site Recovery (RSR)DBRC support of, 394introduction to, 55overview of, 440

Reorganization Process, 123reorganizing

databasesDEDBs, offline, 141DEDBs, online, 144HALDBs, online, 145introduction to, 123offline, 129offline utilities, 130online, 144physical, 124proactive, 125process, overview of, 128purpose of, 124


552 Index

reactive, 125reloading, 133sample guidelines, 127structural, 124unloading, 132Utility Control Facility, using, 131when to reorganize, 124

HALDBs (High Availability Large Data-bases), 128

offline reorganization, 142secondary indexes, 142

monitoring for, 126offline reorganization

HALDBs (High Availability Large Databases), 142

PHDAM databaseoffline reorganization, 142

PHDAM databases, 128PHIDAM database

offline reorganization, 142PHIDAM databases, 128secondary indexes


replace (REPL) callsin a logical database, 265introduction to, 235using a secondary index, 268

reports//DFSSTAT, 415IMS Monitor, 415Statistical Analysis utility, 408

requirementsDASD, 14hardware

direct-access storage devices, 14processors, 14

softwareCICS subsystems supported, 15DB2 subsystems supported, 15programming languages supported, 16

Resource Access Control Facility (RACF)introduction to, 47

Resource Access Security exit routine (DFSRAS00), 352

Resource Manager (RM)


Resource Recovery Services (RRS)sync-point manager, 47

resource translation table (RTT), 237resources

modifying, 421monitoring in data sharing environment,

429securing, 363

response time, 308reduction with MFS, 308transaction, considerations, 291

restart (XRST) calls, 259, 276restart IMS, automatically, 52retrieve calls


RIT (RECON initialization token), 390RM (Resource Manager)

introduction to, 42RNR (Rapid Network Reconnect), 485root segment

introduction of, 72RRS (Resource Recovery Services)

sync-point manager, 47RSR (Remote Site Recovery)

DBRC support of, 394introduction to, 55overview of, 440

RTCODE macro, 335running multiple IMS systems, 44

S

save area, for registers, 350SCAN control block function, 351scheduling

BMP programs, 212Fast Path transactions, 212in a shared-queues environment, 213JBP programs, 212message, 206transactions, 208

SCI (Structured Call Interface)


Index 553


SCI Registration exit routine (DSPSCIX0), 352scratch pad area (SPA), 315SDEP (sequential dependent) segment, 105searching

for segments, 243Secondary Index Database Maintenance exit

routine, 352secondary indexes

creating, 269example of, 80HALDBs (High Availability Large Data-

bases)reorganizing, 142

introduction to, 77loading a database with, 271pointer segment, 77reorganizing


source segment, 77sparse indexing, 80target segment, 77

securing resources, 363Security, 361security

history of, 361modifying, 424overview of, 361securing resources, 363SECURITY macro, 362SMU Maintenance utility, 334

security and IMSintroduction to, 51

SECURITY macro, 335, 362Security Reverification exit routine

(DFSCTSE0), 352segment search argument (SSA)

command codes in, 246general characteristics of, 246introduction to, 243qualification of, 245

segmentsaccess paths, 73accessing

conflicts, 287in a logical database, 265via a secondary index, 267

components of, 84deleting, 253deleting in the index database, 268dependent, 72description, 68inserting, 254inserting in the index database, 269instance

row, compared to, 68layout of, 85parent/child relationship, 70physical design, 85pointer, 77, 85prefix, 84relationships between, 72replacing, 268retrieving, 248root, introduction to, 72searching for, 243siblings, 72source, 77target, 77twins, 72updating, 252

self-healing pointers, 97sequence fields, 73sequential dependent segment (SDEP) segment,

105sequential files, z/OS, 107sessions

definition of, 176distributing, 474establishing, 194

setting up IMS, 49share control, 381share level, in DBRC, 393Shared Printer exit routine (DFSSIML0), 352shared queues

benefits, 202definition, 201environment, 202

components of, illustration, 205operating in, overview, 201


554 Index

required components of, 203routing messages in a sysplex, 483z/OS system log, role of, 203

shared VSO, 104SHARELVL parameter values, 393sharing level, assigning with DBRC, 393shutting down IMS, 56sibling segments, 72Sign On/Off Security exit routine (DFSCSGN0),

352signing off, definition, 476signing on, definition, 476Signoff exit routine (DFSSGFX0), 352Sign-On exit routine (DFSSGNX0), 352single node persistent sessions (SNPSs), 485single point of control (SPOC), 497skeletal JCL, 378SLDS (system log data set)

changing the characteristics of, 435SMP/E

installing with, 50used for maintenance, 334

SMU (Security Maintenance utility)generation process, 334restriction about ETO, 182

SNA (Systems Network Architecture), 175SNPSs (single node persistent sessions), 485sockets

distributing, 474TCP/IP, 478

space program and IMS, 3sparse indexing, 80SPOC (single point of control), 497SSA (segment search argument)

command codes in, 246general characteristics of, 246introduction to, 243qualification of, 245

stage 1, IMS ystem definition, 333stage 2, IMS system definition, 333standard user exit interface

parameter lists, 349START (/START) command

address spaces, starting, 53setting share level, 393

starting IMS, 52

starting regionsapplication, 53batch, 54Fast Path, 53general, 53Java message processing, 54Java non-message processing, 54message processing, 53

STAT (statistics calls), 259static distribution of connections, 474static terminal, 339STATION macro, 335Statistical Analysis utility, 408statistics (STAT) calls, 259STOP (/STOP) command, 424storage limits

OSAM, 111VSAM, 111

structure duplexing in a sysplex, 491structure rebuild in a sysplex, 490structure recovery data set (SRDS)

overview, 205structure, terminal, 339structure, user, 339Structured Call Interface (SCI)


structures, list definitions, 203subsystem records

in RECON data set, 396subsystems

connecting, 436disconnecting, 436effect of commands on, 428structure of, 28

switch, message, 285sync-point manager, Resource Recovery Servic-

es (RRS), 47sysplex

accessing IMS TM, 478bringing IMS into, 469cloned systems, 468components of, 467data sharing, 116, 469definition of, 467dependent regions in, 471


Index 555

distributing transactions, 480using MSC, 482using shared queues, 483

failure recoverycoupling facilities, 490using ARM, 488using multiple servers, 488using structure duplexing, 491using structure rebuild, 490

Fast Database Recovery (FDBR), 471goals of, 468IMS DB in the, 469IMS groups, 471IMS TM, 474

summary of usage, 485introduction to, 467Rapid Network Reconnect (RNR), 485restrictions for data sharing, 470using IMS Connect, 479VTAM Generic Resources, 476

sysplex environment, 201definition, 201shared queues in, 201

system definitionintroduction to, 51

system definition macrosAPPLCTN, 335BUFPOOLS, 335COMM, 335CONFIG, 335CTLUNIT, 335DATABASE, 335FPCTRL, 335IDLIST, 335IMSCTF, 335IMSCTRL, 335IMSGEN, 335LINE, 335LINEGRP, 335MSGQUEUE, 335MSLINK, 335MSNAME, 335MSPLINK, 335NAME, 335POOL, 335RTCODE, 335

SECURITY, 335STATION, 335TERMINAL, 335TRANSACT, 335TYPE, 335VTAMPOOL, 335

System Definition Preprocessor exit routine (In-put Phase) (DFSPRE60), 352

System Definition Preprocessor exit routine (Name Check Complete) (DFSPRE70), 352

system definition processALL, 332BATCH, 332CTLBLKS, 332definition of, 329JCLIN process, 334macros, 335MODBLKS, 332MSVERIFY, 332NUCLEUS, 332ON-LINE, 332overview of, 330running the SMU Maintenance utility, 334SMP/E maintenance, 334stage 1, 333stage 2, 333types of, 332

system exit routinesApplication Group Name (AGN) exit rou-

tine, 352Buffer Size Specification Facility, 352Command Authorization exit routine, 352DBRC Command Authorization exit rou-

tine, 352Dependent Region Preinitialization routine,

352ESAF Indoubt Notification exit routine,

352IMS Command Language Modification fa-

cility, 352Large SYSGEN Sort/Split Input exit rou-

tine, 352Log Archive exit routine, 352Log Filter exit routine, 352Logger exit routine, 352


556 Index

Partner Product exit routine, 352RECON I/O exit routine, 352Resource Access Security exit routine, 352SCI Registration exit routine, 352System Definition Preprocessor exit routine

(Input Phase), 352System Definition Preprocessor exit routine

(Name Check Complete), 352Type 2 Automated Operator exit routine,

352User Message Table, 352

system log, z/OSshared queues and, 203

system modification program/extended (SMP/E)installing with, 50used for maintenance, 334

system recoveryoverview of, 439using RSR, 440using XRF, 440

system service callscheckpoint (CHPK), 259for application programs, 259introduction to, 235list of, 237restart (XRST), 259statistics (STAT), 259

system services, IMS, 13Systems Network Architecture (SNA), 175

T

tasks of DBRC, 376TCP/IP

accessing IMS, 25client communications, 188IMS support of, 46sockets, 478

TCP/IP Telnet, 478terminal input destination, 197TERMINAL macro, 335terminal structure, 339terminal types

dynamic, 197, 339static, 197, 339

terminalsadministering, 422assigning, 422definition of, 12

terminating application programsabnormally, 286normally, 285

termination phase of HALDB Online Reorgani-zation, 148

Time Sharing Option (TSO) single point of con-trol (SPOC), 497

time, transaction response, 291Time-Controlled Operations (TCO) exit routine

(DFSTXIT0), 352time-stamp recovery, 385TM and MSC Message Routing and Control

User exit routine (DFSMSCE0), 352TN3270, 478tools, IMS (IBM)

application management, 447database administration, 443information integration management, 455miscellaneous, 463performance management, 450recovery management, 452TM management, 461utilities management, 456

TP PCBgenerating, 231mask, example of, 227

TRACE (/TRACE) commanddiagnosing problems with, 406for program isolation, 416IMS Monitor, 414VTAM I/O Timeout facility, 422

TRACE CT command, 416trace facility, 418tracing, 418

CTRACE, using, 416GTF trace, 415program isolation and lock, 416

TRANSACT macro, 335translation to uppercase, 308

transactioninput message, 195

Transaction Authorization exit routine


Index 557

(DFSCTRN0), 352Transaction Code (Input) edit routine

(DFSCSMB0), 352transaction code class, 207transactions

assignment, 422conversational, 284, 315definition of, 12distributing in a sysplex, 480

using MSC, 482using shared queues, 483

distributing workload of, 474effect of commands on, 427flow, overview of, 173priorities, 422recovering, 153response time, 291scheduling, 208

transmissiondefinition of, 171

twin segments, 72Type 1 Automated Operator exit routine

(DFSAOUE0), 352Type 2 Automated Operator exit routine

(DFSAOE00), 352TYPE macro, 335types of IMS starts

automatic restart, 52cold start, 52emergency restart, 52normal restart, 52

U

unit of reorganization for HALDB Online Reor-ganization, 148

User Message Table (DFSCMTU0), 352user structure, 339users

assigningISC to, 423LTERM to, 423

dynamic, 339users of IMS, 5utilities

Application Control Blocks Maintenance utility, 230

Batch Backout utility (DFSBBO00), 163Database Change Accumulation utility

(DFSUCUM0), 158Database Image Copy 2 utility

(DFSUDMT0), 157Database Image Copy utility

(DFSUDMP0), 154Database Recovery utility (DFSURDB0),

161Fast Path Log Analysis utility

(DBFULTA0), 407for recovery, 153IMS, introduction to, 54Online Database Image Copy utility

(DFSUICP0), 157PSB Generation utility, 230recovery, 421SMU Maintenance, 334used to initialize a database, 269

Utility Control Facility (DFSUCF00), 131

V

VGR (VTAM Generic Resources), 476viability, IMS's, 4Virtual Storage Access Method (VSAM)

for data set groups, 111IMS's use of, 109storage limits, 111

Virtual Storage Option (VSO)High Speed Sequential Processing (HSSP),

104introduction to, 104multiple area data sets (MADS), 104shared, 104

Virtual Telecommunications Access Method (VTAM)See VTAM (Virtual Tele-communications Access Method), 177

VSAM (Virtual Storage Access Method)for data set groups, 111IMS's use of, 109storage limits, 111

VSO (Virtual Storage Option)


558 Index

High Speed Sequential Processing (HSSP), 104

introduction to, 104multiple area data sets (MADS), 104shared, 104

VTAM (Virtual Telecommunications Access Method)

IMS, relationship to, 177network role, 177VTAM I/O Timeout facility, 422

VTAM Generic Resources (VGR), 476VTAM persistent sessions, support of, 485VTAM USERVAR exit, 475VTAMPOOL macro, 335

W

WADS (write-ahead data set)adding or removing spare, 434characteristics, changing, 434location, changing, 434mode, changing, 434

Web server, distributing connection requests, 479

Web site, IMS, 6, 13WebSphere Application Server for z/OS

applications, 317overview, 317

X

XML (Extensible Markup Language)composition, 65data-centric documents, 324decomposed storage mode, 323intact storage mode

base segment, 325database for, 325explanation of, 325overflow segment, 326side segment, 326

legacy databases, and, 325overview, 321retrieveXML, 321storeXML, 323storing in IMS, 65

XRF (Extended Recovery Facility)introduction to, 55overview of, 440

XRST (restart) calls, 259, 276

Z

z/OSaccess methods used by HD, 98and IMS master terminal, 193component trace (CTRACE) service, 416relationship to IMS, 27sequential files, 107services, how IMS uses, 45system log, 204


index [ptgmedia.pearsoncmg.com]ptgmedia.pearsoncmg.com/images/0131856715/index/... · index symbols...

Documents