By John Horswill, Members of the CICS Development Team at IBM Hursley
Price: $44.95 USD
£31.95 GBP
Cover | Table of Contents | Index | Sample Chapter | Colophon
Index
[ Numbers ], [ A ], [ B ], [ C ], [ D ], [ E ], [ F ], [ G ], [ H ], [ I ], [ J ], [ K ], [ L ], [ M ], [ N ], [ O ], [ P ], [ Q ], [ R ], [ S ], [ T ], [ U ], [ V ], [ W ], [ X ]
Numbers[ Top ]
3270
field structure, 199
information display system, 198
presentation logic component (see presentation logic component)
screen layout, planning, 199
terminals, 198
A[ Top ]
ABCODE option
ABEND command, 92
ASSIGN command, 97
ABEND command, 92, 96
abending transactions, 92, 221
abends (abnormal endings), 20, 26
ECI errors and, 269
HANDLE ABEND routine, 105
including code for, 21
IOERR condition, 80
NACT04 program invoked during, 59
snapshots, 327
transferring control between programs, 86
About to Execute Command, 337
ABPROGRAM option (ASSIGN command), 97
Abstract Window Toolkit (AWT), 300
Access Control Facility (ACF2), 26
accessibility, 6
account detail map
defining, 217-220
notes on, 217
Account Details form (Main Menu panel)
GUI, 261, 263
Visual Basic component, 249
web component, 167
account details web page, 155
account file, 42
business logic component and, 39, 41
handling data, 50-53
updated by transactions, 47
Account Request (Main Menu panel), 248
AccountBean, 158
creating, 170-175
property names
adding, 170
list of, 172
_AccountInterfaceImpl class, methods in, 133-137
_AccountInterfaceImplBase class, 130
_AccountInterfaceImpl.java file, 131
accountObject.idl file, 127
accounts department (sample), 35
ACCT application, running, 287
ACF2 (Access Control Facility), 26
ACID properties, 16-18
ACID transactions, limitations of, 19
adding records, 77
Adobe Reader, 361
affinities, 84
AID (attention identifier), 234
ALARM option
DFHMDI macro, 214
SEND CONTROL command, 231
SEND MAP command, 224
alternate index, 51
AnyNet component, 277
API (Application Programming Interface), 6
CICS, 23, 111, 119
ECI, 252
JCICS, 122
VisualAge Interspace, 258-260
application designer aided by CICS, 22-28
Application Programming Interface (see API)
application server, CICS as, 7
applications
accessing on CICS server, 257, 265-277
with VisualAge Interspace API, 258-260, 270
debugging in CICS, 327-343
designing to use MQSeries-CICS bridge, 291-299
Service Interface Painter for, 258
types of, 3
(see also business applications)
AppName option, 259
ASKIP attribute (DFHMDF macro), 212
ASKTIME command, 106
ASRAINTRPT option (ASSIGN command), 97
ASRAKEY option (ASSIGN command), 97
ASRAPSW option (ASSIGN command), 98
ASRAREGS option (ASSIGN command), 98
ASRASPC option (ASSIGN command), 98
ASRASTG option (ASSIGN command), 99
ASSIGN command, 97-102
NACT04 and, 96
asterisk (*) in map comments, 217
asynchronous calling, 24
atomicity, 17
attention identifier (AID), 234
attention keys, 233
ATTRB option (DFHMDF macro), 212
authentication, 26
authorization, 26
auxiliary storage, 45
availability of applications, 6
AWT (Abstract Window Toolkit), 300
B[ Top ]
backing out from updates, 56, 104
BASESPACE value (ASRASPC option, ASSIGN command), 98
Basic Mapping Support (see BMS)
<BEAN ... tag, 181
beans, 158
(see also JavaBean; AccountBean)
BMS (Basic Mapping Support), 198, 208-222
errors, 236
menu map, 210
Bridge Monitor, 323
browse commands, 69
using in sample application, 71-76
browsing
files, 69-76
records, 55, 60
BRT attribute (DFHMDF macro), 212
buildCA( ), 119, 136
business applications, 3, 4-7
CICS, using for, 8-11
components, 13
building, 28-30
designing, 5, 12-30
developing cross-functional teams, 32-33
sample application, 31-36
designing, 34-36
value, creating with, 7
(see also applications)
business case, 31-33
business intelligence applications, 3
business logic components, 14
connecting to Web, 109
programs for, 58-60
(see also COBOL component)
business operations applications (see business applications)
business transactions (see transactions)
byte arrays, 134
buildCA( ), 136
C[ Top ]
CA-ACF2 (Access Control Facility), 26
CALL statement (COBOL), 85
callCRUD( ), 118, 135
capacity (bandwidth), 45
CclOUOW class, 267
CD-ROM with this book, xi
ACCT application, 287
COBOL source programs, 61
files
list of, 362-364
uploading, 348-352
GenFacIOR utility, 147
host.dat file (sample), 126
IDL definition, creating, 127
Implementation class for sample application, 131
MQSeries for Windows NT, files for, 307
MQSeries-Java client, 300
NACCBRWS copybook, 72
NACT02 program, 54
pdf files for CICS TS for OS/390 Version 1.3, 361
sample application
Implementation class for, 131
installing, 348
Visual Basic component, code for, 261
CEBR transaction, 330
CECI transaction, 331
CEDF transaction, 327, 333
running, 336
CEDX transaction, 327, 333
CEMT transaction, 329
CETR transaction, 330
CGI (Common Gateway Interface), 157
channel type, 311
character literal, 63
CHLTYPE, 311
CICS
application designer, help for, 22-28
as application server, 7
applications
business, using for, 8-11
communicating with, 260, 277-287
designing access to/control of, 252-260
traditional, 16
COM libraries, 257
debugging in, 327-343
design guidelines, 43-49
incorporating, 202-205
ECI. link call to, 267-269
initializing VisualAge Interspace to at startup, 275
I/O waits, 69
Java environment in, 110, 112
as middleware, 6
MQSeries, setting up to use, 307-323
for OS/390, 313-322
for Windows NT, 307-312
MQSeries-CICS bridge, setting up to use, 313
object-oriented support, 257
program name, adding to message buffer, 303
programming facilities provided by, 28
reasons for using/extending, 7
region
configuring for OS/390, 347-361
connecting to MQSeries from, 318
handling dynamically, 328
server application, exporting/binding to, 137-140
resource definitions, setting up/installing, 353
resources
defining, 355-360
enquiring into status of, 329
SYSIDERR condition, 82
system services, 61-63
as transaction processing system, 6
Transaction Server (see CICS Transaction Server)
transactions (see transactions)
translator, 63
not required for Java, 111
CICS bridge queue, remote definition, 310
CICS client, establishing connection with server, 278
CICS Client software, 25
CICS DPL programs, running, 297
CICS Glossary, 365
CICS programs, 23-25
mapping functions to, 56-58
writing in COBOL, 61-64
CICS region (see CICS, region)
CICS server
accessing applications on, 257, 265-277
with VisualAge Interspace API, 258-260, 270
establishing connection with client, 278
CICS Transaction Gateway, 25
CICS Transaction Server, xi
data conversion and, 256
for OS/390
configuring, 279
data conversion and, 282
Version 1.3, 110-114
CICS TS library for OS/390 Version 1.3, pdf files for, 361
CICS Universal Client
communicating with CICS applications, 277
configuring, 284-285
data conversion and, 256
Version 3.1, 257
COM library, 266-270
CICS value (ASRASTG option, ASSIGN command), 99
CICSEXECKEY value (ASRAKEY option, ASSIGN command), 98
CICSJADP group, 356
cicsterm session, 285
CICS-value data area (cvda), 103
CKBP transaction, 313
CKBR transaction, 313
client components, 13
client program, creating, 140-147
ClientStub object, instantiating, 184
ClientStub.java file, modifying, 187-190
CLIENT.TO.NTQMGR, 311
CMAC transaction, 329
.cmd files, 322
COBOL
CICS programs, writing in, 61-64
console I/O verbs, 64
file processing verbs, 64
map structure, copying into, 222
programs, standard vs. CICS, 63
COBOL CALL statement, 88
COBOL component
configuring, 352-354
data handling, 49-53
data structure, 41
designing, 39-60
estimating the workload, 42
files used by, 362-364
programming, 61-106
restrictions, assessing, 41
services interface (see Visual Basic component; GUI)
what it needs to do, 40-43
COM libraries, 257
ECI COM library, writing, 266-270
Command Execution Complete debugging screen, 337
command security, 27
commands, syntax of, 331
COMMAREA fields, adding to message buffer, 303
COMMAREA option
LINK command, 87
RETURN command, 88
COMMAREAs, 24, 57, 83
byte arrays, 268
ECI, 259
setting fields for, 276
setting up for VisualAge Interspace Service, 271
committing changes, 18
common error handler, 53
Common Gateway Interface (CGI), 157
Common Object Request Broker Architecture (see CORBA)
Common Work Area (CWA), 84
communicating with CICS applications, 277-287
communication bandwidth, 45
compiling IDL definition, 127-130
complete isolation, 19
component interfaces, 16
Component Object Module (COM) libraries, 257
components, 13-16
AnyNet, 277
building, 28-30
COBOL
designing, 39-60
programming, 61-106
error handling and, 20
Java
designing, 109-120
programming, 121-150
presentation logic
designing, 197-206
programming, 207-242
Visual Basic
designing, 245-260
programming, 261-287
web
designing, 153-161
programming, 162-193
comsubs.bas module, 265
configuring
CICS region for OS/390, 347-361
CICS Transaction Server for OS/390, 279
CICS Universal Client, 284-285
COBOL component, 352-354
ET/390 host environment, 125
Java component for OS/390, 355-361
MQSeries, 296
servlets, 164
VTAM for OS/390, 280-281
web server, 162
Windows NT HOSTS file, 283
Confirm Delete button (Main Menu panel), 250
CONNAME option, 311
Define channel, 315
connection handles, 292
consistency, 17
Continue option (EDF), 335
control information, sending without data, 231
control, returning to previous program, 87
controlling programs (see programs, controlling)
conversational transactions, 203
COPY statement, 222
CORBA
in CICS environment, 111-113
IIOP applications, 114
services, 112
CORBA client
creating, 139-148
getAccount( ), 134
implementing, 160
incorporating, 183
Create Account button (Main Menu panel), 250
Create command, 254
Create option, 254
Create/Read/Update/Delete functions (see CRUD functions)
creating
AccountBean, 170-175
client program, 140-147
CORBA client, 139-148
error.jsp file, 183
genfac.ior file, 147
IDL definition, 127-130
Java servlet, 175-178
JSP files, 178-183
locks on accounts, 53
MQSeries messages, 303
projects, 169
records, 54
RunClient class, 147-149
value with business applications, 7
VisualAge Interspace service for NACT02, 270-277
web pages, products for, 166
cross-functional team, 32-33
CRUD (Create/Read/Update/Delete) functions, 53, 54, 59
CSD definitions file, editing, 353
CSQCBP00 transaction, 313
CSQCBP10 transaction, 313
CSQCBR00 transaction, 313
CSQCBTX transaction, 313
CSQCKB group, adding to startup group list, 313
CTRL option
DFHMDI macro, 213
DFHMSD macro, 216
CURSOR option
SEND CONTROL command, 231
SEND MAP command, 224
cursor, positioning of, 229
customer account file (see account file)
customer account object
creating IDL definition for, 127-130
describing, 116-118
customer account records (see records)
customer accounts, viewing with MQSeries-CICS bridge, 291
Customer Information Control System (see CICS)
customer services department, 245
sample, 35
cvda (CICS-value data area), 103
CWA (Common Work Area), 84
D[ Top ]
data conversion
between CICS Transaction Server and CICS Universal Client, 256
for COMMAREA within ECI request, 281
DATA DIVISION, 63
data handling
COBOL component, 49-53
on CICS server, 265
data set name, 65
data structure, COBOL component, 41
data validation
designing, 251
implementing code for, 264
data warehousing applications, 3
database support, 51
DATAONLY option (SEND MAP command), 225
datasets, receiving, 351
datatypes for AccRecord, 265
date/time stamp, adding, 106
dcidpl.bas module, 258
dcigel.bas module, 258
DCT (Destination Control Table), 94
deadlock, 19
debugging
in CICS, 327-343
components, 29
with EDF, 333-343
defining
CICS resources, 355-360
MQSeries for OS/390 objects, 314-318
DEFPSIST attribute, 312, 318
DELETE command, 78
Delete option, 254
deleting records, 78
DEname item, 259
deploying components, 30
design applications, 3
designing
access to/control of CICS applications, 252-260
application to use MQSeries, 291-299
business applications, 5, 12-30
sample application, 34-36
COBOL component, 39-60
components, 28
data validation, 251
error handling, 260
GUI, 246-250
Java application, 296
Java component, 109-120
online help, 251
presentation logic component, 197-206
functions of, 205
print function, 250
user interface, 201
web component, 153-161
web server components, 156-160
Destination Control Table (DCT), 94
DET attribute (DFHMDF macro), 212, 213
developing business applications, 5
cross-functional team, 32-33
DFHCNV macro, 282
DFHCOMMAREA, 87, 88
DFHCSDUP utility program, 25
DFHMDF macro, 211
generating map definition for field, 210-213
DFHMDI macro, generating map definition, 213
DFHMSD macro, 214, 216
dfjcics.jar file, 119, 122
dfjcidl.jar file, 114, 122, 123
dfjcorb.jar file, 119, 122, 123
DIL (Distributed Interface Layer), 258
DISABLED condition, 79
displayRecord method, 307
Distributed Interface Layer (DIL), 258
distributed objects, CICS vs. ORB, 113
Distributed Processing Layer (DPL), 258
Distributed Program Link (DPL), 52
distribution, CICS used in, 10
division of responsibilities, 4
DPL (Distributed Processing Layer), 258
DPL (Distributed Program Link), 52
DRK attribute (DFHMDF macro), 212, 213
DSECT attribute (DFHMSD macro), 215
DSECTs, notes on, 223
DUMP TRANSACTION command, 104
DUMPCODE option (DUMP TRANSACTION command), 104
dumps, 26, 92, 327
processing, 329
third-party software for, 328
DUPKEY condition, 79
DUPREC condition, 79
durability, 18
E[ Top ]
e-business strategy, implementing with CICS, 8
ECI (External Call Interface), 16, 25
COM library, writing, 266-270
link call to CICS, 267-269
linking to, 259
understanding, 255
EDF (Execution Diagnostic Facility), 28, 333-343
displays, examples of, 336-342
options, 335
transactions for, 333
EIB (EXEC Interface Block), 96, 233-236
debugging screen, 336
EIBAID field, 234, 235
EIBCALEN field, 234
EIBCPOSN field, 234
EIBDATE field, 234
EIBDS field, 234
EIBFN field, 234
EIBRESP field, 234
EIBRESP2 field, 235
EIBRSRCE field, 235
EIBTASKN field, 235
EIBTIME field, 235
EIBTRMID field, 235
EIBTRNID field, 235
ENDBR command, 71
ENDFILE condition, 79
Enquiry option, 254
Enter key, 335
Enterprise Toolkit/390 (see ET/390)
ENTRYPOINT option (INQUIRE PROGRAM command), 102
ENVIRONMENT DIVISION, 63
EPI (External Presentation Interface), 16, 25
EQUAL option (STARTBR command), 70
ERASE option
SEND CONTROL command, 231
SEND MAP command, 225
ERASEUP option
SEND CONTROL command, 231
SEND MAP command, 225
error handling, 19-21, 55, 96-106
business logic component, 48
CICS ECI COM classes, 269
designing, 260
facilities for, 26
NACT04 program for, 59
presentation logic component, 205, 208
error notification, 20
error.jsp file, creating, 183
errors, 20
BMS commands, 236
CICS-related, checking for, 305
error map, defining, 221
error web page, 155
on file commands, 79
in IDL objects, 130
MAPFAIL, 237
menu screen and, 199
on program control commands, 91
RETRIEVE command, 240
START command, 240
types of, 20
ET/390, 121
configuring host environment, 125
EXEC CICS commands, converting, 63
EXEC Interface Block (see EIB)
Execution Diagnostic Facility (see EDF)
External Call Interface (see ECI)
External Presentation Interface (see EPI)
extrapartition transient data, 95
F[ Top ]
fast paths (Main Menu panel), 249
fat clients, 111
faults, 20
FC (File Control), 25
FCI option (ASSIGN command), 99
FCT (see File Control Table)
file commands, errors on, 79
File Control (FC), 25
File Control Table (FCT), 25, 63
FILE definitions, 63
file integrity, maintaining, 46
FILE option, 62
READ command, 65
REWRITE command, 77
DELETE command, 78
file records (see records)
FILE SECTION, 63
FILENOTFOUND condition, 80
files
browsing, 69-76
DISABLED condition, 79
ENDFILE condition, 79
FILENOTFOUND condition, 80
handling, 64-83
IOERR condition, 80
NOSPACE condition, 81
NOTFND condition, 81
NOTOPEN condition, 82
publishing to web server, 190
saving with scratchpad, 83
uploading from CD-ROM, 348-352
financial services, CICS used in, 9
fldname item, 210
footprints, 327
format rules for macros, 216
FORMATTIME command, 106
FORMFEED option
SEND CONTROL command, 231
SEND MAP command, 226
FREEKB option
DFHMDI macro, 214
SEND CONTROL command, 231
SEND MAP command, 226
FROM area, 24
FROM option, 63
REWRITE command, 77
START command, 238
WRITEQ TD command, 95
FRSET option
DFHMDI macro, 214
SEND CONTROL command, 231
SEND MAP command, 225
FSET attribute (DFHMDF macro), 212
FTP commands for uploading files, 349
functions, 62
G[ Top ]
GEL (GUI-Enabling Layer), 258
genfac.ior file, creating, 147
GenFacIOR utility, 147
get calls, 292
getAccount( ), 118, 130, 134
invoked by CORBA client, 161
getfieldname method, 306
getter method, 175
getting messages, 292
glossary, 365-378
GOBACK statement, 88
graphical user interface (see GUI)
groupware applications, 3
GRPNAME option (DFHMDF macro), 211
GTEQ option (STARTBR command), 70
GUI (graphical user interface)
consulting with users about, 245
data fields, 265
designing, 246-250
MQSeries-CICS bridge, 295
GUI-Enabling Layer, 258
Java, building, 300
writing code for, 261-264
guidelines
CICS design, 202-205
for user interface design, 201
GUI-Enabling Layer (GEL), 258
H[ Top ]
HANDLE ABEND routine, 105
HARDENBO attribute, 318
hardware, prioritized use of, 6
head office (sample), 35
help, error handling design, 260
help options, 251, 264
helpdesk, 251
host.dat file, 126
Hummingbird, 124
I[ Top ]
IBM Dictionary of Computing, 365
IC attribute (DFHMDF MACRO), 212
IDL (Interface Definition Language), 112
compiler, importing, 123
customer account object, 116-118
definition, creating/compiling, 127-130
development environment, 124
IDL-to-Java compiler, 112
IDL definition, compiling, 128
IIOP (Internet Inter-ORB Protocol), 25
applications, 114
packages for downloading and importing, 122
protocol, CICS support for, 113-115
ILLOGIC condition, 80
information, CICS used in, 10
INITIAL option (DFHMDF macro), 211
INITQ, 310
INQUIRE PROGRAM command, 102-103
<INSERT BEAN... tags, 181
installed program definitions, 85
installed transaction definitions, 85
installing
CICS resource definitions, 353
sample application from CD-ROM, 348
web server, 162
interception points, 333
Interface Definition Language (see IDL)
Internet Inter-Orb Protocol (see IIOP)
Interoperable Object Reference (IOR), 114
Interspace API call, 259
INTERVAL option (START command), 238
INTO option, 63
READ command, 66
RETRIEVE command, 239
intrapartition transient data, 94
invalid requests, 80
INVOKINGPROG option (ASSIGN command), 99
INVREQ condition, 80
program control commands, 91
INVTSREQ condition (START/RETRIEVE commands), 240
I/O waits, CICS and, 69
IOERR condition, 80
START/RETRIEVE commands, 240
IOR (Interoperable Object Reference), 114
IP address of host machine, 311
ISCINVREQ condition, 81
isolation, 17, 19
ISSUE DISCONNECT command, 106
J[ Top ]
Java
application
coding, 301-307
designing, 296
benefits of using MQSeries for, 299
in CICS environment, 110, 112
GUI, building, 300
Java component
configuring for OS/390, 355-361
designing, 109-120
implementing, 119
programming, 121-150
development environment for, 122-126
setting up on OS/390, 360
what it needs to do, 115
Java servlet, 157
creating, 175-178
JavaBean, 158
property names
adding, 170
list of, 172
JavaServer Pages (JSP files), 159
creating, 178-183
deciding which to return to user, 184
JCICS API, 122
JCICS classes, importing, 123
JCICS Java class library, 110, 118
journal updates, 52
JSP files (see JavaServer Pages)
JSP tags, 159
JTable object, 300
L[ Top ]
LANG option (DFHMSD macro), 215
latency (bandwidth), 45
legacy data, 111
LENGERR condition
file commands, 81
program control commands, 92
START/RETRIEVE commands, 240
LENGTH option
DFHMDF macro, 211
DFHMDI macro, 214
INQUIRE PROGRAM command, 102
LINK command, 87
READ command, 66
RETRIEVE command, 239
RETURN command, 88
REWRITE command, 77
START command, 238
WRITE command, 77
XCTL command, 87
lifecycle requirements of business applications, 5
line of business applications (see business applications)
link calls, ECI to CICS, 267-269
LINK command, 23, 86
NACT04 and, 96
LINKAGE section, 64
linking CICS programs, 23-25
listener, starting on OS/390, 321
LOAD command, 93
LOADPOINT option (INQUIRE PROGRAM command), 103
local printing, 241
local queue, 309
OS/390, 317
locate mode, 63
locking file, 51
locks on accounts, 46
creating/freeing, 53
Log in panel, designing, 247
logical levels, 24
LU6.2 protocol, 277
M[ Top ]
macros, format rules, 216
Main Menu panel
controls on, 261
designing, 247-250
manageability, 6
manufacturing applications, 3
MAP attribute (DFHMSD macro), 215
map definitions, 210-216
generating with DFHMDI macro, 213
macros for, 210-213
sample application, 217-221
MAP option
RECEIVE MAP command, 232
SEND MAP command, 224
map set, 221
defining with DFHMSD macro, 214
map structure, copying into program, 222
MAPFAIL errors, 237
mapname item, 213
MAPONLY option (SEND MAP command), 226
mapping functions to CICS programs, 56-58
maps
account detail, 217-221
symbolic description, 222-223
writing to terminals, 224-240
mapset item, 214
MAPSET option
RECEIVE MAP command, 232
SEND MAP command, 224
MAPSET program object, 210
MCAUSER, 311
MDI (multiple document interface), 246
menu map, defining with BMS macros, 210-216
menu screen, 199
displayed by NACT01, 207
message buffer, adding CICS program name/COMMERA fields to, 303
message channel agent user, 311
message channels, 311
message persistence, 312
Message Queue Interface (see MQI)
messages
information about, 329
putting/getting, 292
request, sending to bridge queue on MQSeries, 304
response, receiving, 304
start unit of work, 297
trigger, 309
writing to consoles, 105
middleware, 6
MODE option (DFHMSD macro), 215
move mode, 63
MQClient.java, 300
MQI (Message Queue Interface), 291
calls, 291
channel, 311
MQPUT1 calls, 293
MQSeries, 25, 26, 291-293
configuring, 296
connecting to from CICS region, 318
for Windows NT, starting, 312
messages, creating, 303
OS/390
objects, defining for, 314-318
setting up, 313
queues, opening, 302
reasons for using, 298
Windows NT, defining for, 307-312
MQSeries-CICS bridge, 294
designing application to use, 291-299
programming, 300-322
running, 322
setting up, 307-323
for OS/390, 313-322
for Windows NT, 307-312
starting, 320
troubleshooting, 322
MQSeries Explorer, 292
troubleshooting and, 323
using, 307
MSGDLVSQ attributes, 318
multiple document interface (MDI), 246
MVS DDNAME, 65
N[ Top ]
NACCBRWS copybook, 72
NACP transaction, 241
NACT transaction, 207, 208, 285
resource names associated with, 354
RLS and, 356
NACT02 program, 54, 58, 59
creating VisualAge Interspace service for, 270-277
server application, request and reply structures, 276
NACT03 program, 241
NACT04 program, 58, 59, 96-106
transient data and, 95
NACT05 program, 55, 58, 60
name file, 51
NETNAME option (ASSIGN command), 100
network drive, mounting, 124
news and information, CICS used in, 10
Next Display option (EDF), 335
NFS client, 124
NFS Maestro Solo (Hummingbird), 124
NOHANDLE option (READ command), 66
NONCICS value (ASRAKEY option, ASSIGN command), 98
non-terminal transactions, 333
NORM attribute (DFHMDF macro), 212
NOSPACE condition, 81
NOTAPPLIC value
ASRAKEY option, ASSIGN command, 98
ASRASPC option, ASSIGN command, 99
ASRASTG option, ASSIGN command, 99
NOTAUTH condition, 81
program control commands, 92
NOTFND condition, 81
START/RETRIEVE commands, 240
NOTOPEN condition, 82
NOTRIGGER, 310
NUM attribute (DFHMDF macro), 212
O[ Top ]
object handles, 292
Object Request Broker (see ORB)
object-oriented support by CICS, 257
OCCURS option (DFHMDF macro), 211
Olympics, 10
online help
designing, 251
implementing, 264
opening
MQSeries queues, 302
queues, 292
operating system, OERR condition, 80
options, 62
ORB (Object Request Broker), 112
classes, importing, 123
OS/390
configuring CICS region on, 347-361
defining queues on, 314
listener, starting, 321
MQSeries, setting up, 313
MQSeries-CICS bridge, setting up to use, 313-322
objects, defining MQSeries for, 314-318
output screen, 167
P[ Top ]
panel identification field, 260
Partition Data Set Extended (see PDSEs)
Password item, 259
PCOMM (Personal Communications), uploading files with, 349-351
pdf files, CICS TS library for OS/390 Version 1.3, 361
PDSEs (Partition Data Set Extended), 119, 122, 355
performance statistics, 23
Personal Communications (PCOMM), uploading files with, 349-351
personal productivity applications, 3
PF keys, 334
PGMIDERR condition, program control commands, 92
physical map, 209
POS option (DFHMDF macro), 211
presentation logic component, 14, 15
designing, 197-206
programming, 207-242
what it needs to do, 197-200
Previous Display option (EDF), 335
print function
designing, 250
implementing, 264
PRINT option
DFHMDI macro, 213
SEND CONTROL command, 231
SEND MAP command, 226
Print_Click( ), 250
problem determination (see debugging)
processor storage, 44
processor time, 45
production applications, 3
program calls, 23
program control commands, 85, 93
errors on, 91
Program Initiation with EIB debugging screen, 336
PROGRAM option (LINK command), 87
Programmer's Guide (Visual Basic), 246
programming
CICS facilities for, 28
COBOL component, 61-106
components, 29
Java component, 121-150
MQSeries-CICS bridge, 300-322
presentation logic component, 207-242
Visual Basic component, 261-287
web component, 162-193
programs, 23
associating, 85
browsing for errors, 102-103
CICS (see CICS programs)
controlling, 84-92
commands for, 85
errors on commands, 91
invoking with COBOL CALL statement, 88
linking to, 86
callCRUD( ), 135
PROT attribute (DFHMDF macro), 212
proxies (see stubs)
pseudo-conversational processing, 204
pseudo-conversational transactions, 47, 83, 204
put calls, 292
putting messages on queues, 292
Q[ Top ]
QLOCAL, 309
QREMOTE, 310
queue managers, 291
remote, name of, 310
using more than one, 293
QUEUE option (WRITEQ TD command), 95
queues, 291
local, 309
opening, 292
remote, 310
reply-to, 312
transmission, 309
name of, 311
usage of, 310
queuing facilities, 93-95
R[ Top ]
RACF (Resource Access Control Facility), 26
rapid response, 6
RDO (Resource Definition Online), 25
READ command, 65
using in sample application, 67-69
READNEXT command, 55, 65, 70
READONLY value (ASRASTG option, ASSIGN command), 99
READPREV command, 65
Reason Code, 250
receive commands, uploading files and, 349
RECEIVE MAP command, 231
receiver channel (OS/390), 316
receiving component, 20
records
adding, 77
browsing, 55
creating/reading/updating, 54
deleting, 54, 78
reading next, 70
rewriting, 77
recoverability, 6
RELEASE command, 93
reliability, 6
remote definition of CICS bridge queue, 310
remote queues, 310
manager, name of, 310
name of, 310
OS/390, 317
reply-to queue, 312
request message, sending to bridge queue on MQSeries, 304
request strings, converting to byte arrays, 136
REQUESTMODEL option, 358
REQUESTMODEL resource definition, 120
Resource Access Control Facility (RACF), 26
Resource Definition Online (RDO), 25
resource security, 27
resources
defining for CICS, 25
monitoring, 23
using efficiently, 44-45
(see also CICS, resources)
resources for further reading
CICS, 379-381
CICS terminals, 209
CORBA, 113
Java, 112
Swing, 300
RESP option (READ command), 67
RESP2 option (READ command), 67
response message, receiving, 304
responsibilities, division of, 4
retail business, CICS used in, 10
RETRIEVE command, 24, 239-240
sample application, 239
return codes in commands, 26
RETURN command, 87
RETURNPROG option (ASSIGN command), 100
reuseability, 13
business logic components and, 14
REWRITE command, 77
rewriting records, 77
RIDFLD option, 62, 70
READ command, 66
REWRITE command, 77
DELETE command, 78
RNAME, 310
ROLLBACK option (SYNCPOINT ROLLBACK command), 105
RQMNAME, 310
RunClient class
creating, 147-149
testing, 148
running
MQSeries-CICS bridge, 322
sample application, 354
S[ Top ]
SAM (sequential access method) files, 95
sample application, 31-36
preparing to install, 348
running, 347, 354
scaleability, 6
scratchpad, 51
saving files with, 83
Screen Definition Facility II (SDF II), 210
screens, defining with BMS, 208-222
screen-scraping, 16
SDF II (Screen Definition Facility II), 210
SDI (single document interface), 246
security, 6, 26-27
Visual Basic component and, 246
security check, NOTAUTH condition, 81
SEND CONTROL command, 231
SEND MAP command, 224-230
sample application, 226-229
sender channel
OS/390, 316
starting, 318
sequence numbers, 312
sequential access method (SAM) files, 95
sequential file facilities, 83
SEQWRAP, 312
server application, exporting/binding to CICS region, 137-140
server components, 13
server implementation class, writing, 130-137
Service Interface Painter, 258
services for running transactions, 27
servlets, 156-158
configuring, 164
reasons for choosing, 159
SET parameter, 63
set-for-publication icon, 173
setter method, 175
SHARE attribute, 317
shared resources, 44
shortcuts (Main Menu panel), 249
signalling component, 20
single document interface (SDI), 246
single-user resources, 45
SIZE option (DFHMDI macro), 213
skeletons, 112
snapshots, 327
software development applications, 3
START command, 24, 238-240
sample application, 239
start unit of work message, 297
STARTBR command, 55, 69
STARTCODE option (ASSIGN command), 101
startup group list, adding CSQCKB group to, 313
STOP `literal' form (COBOL), 64
storage
auxiliary, 45
processor, 44
temporary (see temporary storage)
working, 335, 341
STORAGE option (DFHMSD macro), 216
string variables, 174
stubs, 112
subroutines, 89
SUBSPACE value (ASRASPC option, ASSIGN command), 98
Swing, for GUIs, 300
Switch HEX/CHAR option (EDF), 336
symbolic cursor positioning, 230
symbolic description maps, 210, 222-223
DSECT attribute, 215
symbolic filename, 65
synchronous calling, 23
syncpoint, 18, 22, 45
SYNCPOINT ROLLBACK command, 104
SYSIDERR condition, 82
SYSTEM.CICS.BRIDGE.QUEUE, 310
T[ Top ]
Tab Index property, 250
tab indexes (Main Menu panel), 248
Task Termination debugging screen, 341
tasks (see transactions)
TCP62 connection, testing, 285
TCP62 driver, 277-278
TCPIPSERVICE option, 356
TCPIPSERVICES resource definition, 119
technical requirements of business applications, 6
temporary storage (TS), 25, 94, 205
vs. transient data, 95
temporary-storage queue, 330
TERMCODE option (ASSIGN command), 101
TERMID option (START command), 238
TERMIDERR condition (START/RETRIEVE commands), 240
terminal input command, 231
terminal output commands, 224-231
terminals
disconnecting, 106
writing maps to, 224-240
terminator, 62
testing, 191
business applications, 5
components, 29
RunClient class, 148
TCP62 connection, 285
VisualAGe Interspace service, 273
TEXT option (WRITE OPERATOR command), 105
TIME option (START command), 239
time stamp, adding, 106
TIOAPFX option (DFHMSD macro), 216
tools for debugging, 327
tooltip text, 251, 264
TopSecret security manager, 26
trace table, 327
traces, 26, 328, 330
processing, 329
third-party software for, 328
transaction identifier, 199
transaction processing system, CICS as, 6
transaction security, 27
Transaction Server (see CICS Transaction Server)
Transaction Work Area (TWA), 84
transactions, 16-19, 328-333
abending, 92, 221
associating, 85
communicating between in sample application, 91
conversational, 203
vs. pseudo-conversational, 202-205
dumps of, 92
frequency of, estimating, 42
non-conversational, 203
non-terminal, 333
problem determination, 48
pseudo-conversational, 83, 204
services for running, 27
starting another, 238-240
types of, 3
as understood by CICS, 204
updating account file, 47
transfer control command (see XCTL command)
transferring control between programs, 86
TRANSID option
RETURN command, 88
START command, 238
TRANSID resource definition, 120
TRANSIDERR condition (START/RETRIEVE commands), 240
transient data, 94
queries, 330
vs. temporary storage, 95
transmission queue, 309
name of, 311
OS/390, 316
transport type, 311
TRIGDATA, 309
TRIGGER, 310
trigger messages, 309
troubleshooting MQSeries-CICS bridge, 322
TRPTYPE, 311
TS (see temporary storage)
TWA (see Transaction Work Area)
TYPE option (DFHMSD macro), 215
U[ Top ]
Units of Work (see UOW)
UNPROT attribute (DFHMDF macro), 212
UOW (Units of Work), 22
link calls within, 267
start message for, 297
Update command, 254
UPDATE option, 62, 254
READ command, 66
updates, backing out from, 56, 104
updating business applications, 5
URLs
CICS home page, 9
IBM Dictionary of Computing, 365
Java, 112
OMG, 113
Swing, 300
USAGE, 310
use of hardware, prioritized, 6
user interface, designing, 201
USER value (ASRASTG option, ASSIGN command), 99
USEREXECKEY value (ASRAKEY option, ASSIGN command), 98
UserName item, 259
users
consulting with
for GUI design, 245
for screen layout, 200
about work habits, 40
cursor placement and, 229
MAPFAIL and, 237
V[ Top ]
value, creating with business applications, 7
verify (VFY) field, 230
view account web page, 155
HTML file for, 166
Visual Basic component
designing, 245-260
programming, 261-287
what it needs to do, 245
Visual Basic module, generating for VisualAge Interspace Service, 274
Visual Basic Programmer's Guide, 246
Visual Basic with Interspace Customer Service Application, 287
VisualAge for Java, 119
VisualAge for Java for Windows NT, Enterprise Edition, 121
VisualAge Interspace
accessing applications with, 270
API
accessing applications on CICS server with, 258-260
calls, coding, 275
DPL (Distributed Processing Layer), 256
exiting, 276
initializing to CICS at startup, 275
requests and replies, 276
service
creating for NACT02, 270-277
testing, 273
Service Interface Painter for, 256
tool for, 25
VSAM file, setting up, 352
VSAM key-sequenced data sets, 42, 50, 65
VSAM records, DUPKEY condition, 79
VTAM for OC/390, configuring, 280-281
W[ Top ]
WAS (see WebSphere Application Server)
web component
designing, 153-161
programming, 162-193
what it needs to do, 154
web interface, designing, 155
web pages, products for creating, 166
web server
installing/configuring, 162
publishing files to, 190
web server components
designing, 156-160
programming, 167-192
web site, building, 166-168
WebSphere Application Server (WAS), 162
WebSphere Studio, 162, 163, 168
Java Server Pages, generating, 178
WhatsThisHelp facility, 251, 264
Windows NT
HOSTS file, configuring, 283
MQSeries, starting, 312
MQSeries-CICS bridge, setting up, 307-312
working storage
debugging screen, 341
option, 335
WORKING-STORAGE section, 64
WRITE commands, 76-83
using in sample application, 78
write once, run anywhere, 299
WRITE OPERATOR command, 105
WRITEQ TD command, 95
writing records, 77
X[ Top ]
X icon, 130
XCTL command, 87
NACT04 and, 96
XMITQ, 311
XVTL command, 23
About O'Reilly | Contact | Jobs | Press Room | How to Advertise | Privacy Policy
|
© 2008, O'Reilly Media, Inc. | (707) 827-7000 / (800) 998-9938
All trademarks and registered trademarks appearing on oreilly.com are the property of their respective owners.