Sign In
Upload
Manuals
Brands
IBM Manuals
Software
REXX
IBM REXX Programming Language Manuals
Manuals and User Guides for IBM REXX Programming Language. We have
1
IBM REXX Programming Language manual available for free PDF download: Manual
IBM REXX Manual (481 pages)
CICS Transaction Server for VSE/ESA
Brand:
IBM
| Category:
Software
| Size: 1.78 MB
Table of Contents
Table of Contents
5
Preface
21
What this Book Is about
21
What You Need to Know to Understand this Book
21
Prerequisites
21
Who this Book Is for
21
Part 1. User's Guide
23
Chapter 1. Introduction
25
What Is REXX
25
Features of REXX
25
Ease of Use
25
Free Format
25
Convenient Built-In Functions
25
Debugging Capabilities
25
Interpreted Language
25
Extensive Parsing Capabilities
25
Components of REXX
26
Chapter 2. Writing and Running a REXX Program
27
What You Need to Run a REXX Program
27
What Is a REXX Program
27
Syntax of REXX Instructions
28
The Format of REXX Instructions
28
The Letter Case of REXX Instructions
28
Types of REXX Clauses
31
Programs Using Double-Byte Character Set Names
32
Typing in a Program
33
Running a Program
33
Interpreting Error Messages
34
How to Prevent Translation to Uppercase
35
Characters Within a Program
35
Characters Input to a Program
36
Exercises - Running and Modifying the Example Programs
36
Passing Information to a Program
36
Getting Information from the Program Stack or Terminal Input Device
36
Specifying Values When Calling a Program
37
Preventing Translation of Input to Uppercase
38
Passing Arguments
39
Chapter 3. Using Variables and Expressions
41
Program Variables
41
Using Variables
41
Variable Names
41
Variable Values
42
Using Expressions
43
Arithmetic Operators
43
Comparison Operators
45
Logical (Boolean) Operators
47
Concatenation Operators
49
Priority of Operators
50
Tracing Expressions with the TRACE Instruction
51
Tracing Operations
51
Tracing Results
52
Exercises - Using the TRACE Instruction
52
Chapter 4. Controlling the Flow Within a Program
55
Conditional, Looping, and Interrupt Instructions
55
Using Conditional Instructions
55
IF...THEN...ELSE Instructions
55
Nested if
56
Select When
59
Using Looping Instructions
61
Repetitive Loops
61
Conditional Loops
64
Combining Types of Loops
68
Nested DO Loops
68
Using Interrupt Instructions
70
EXIT Instruction
70
CALL and RETURN Instructions
71
SIGNAL Instruction
72
Chapter 5. Using Functions
73
What Is a Function
73
Example of a Function
73
Built-In Functions
74
Arithmetic Functions
75
Comparison Functions
75
Conversion Functions
75
Formatting Functions
76
String Manipulating Functions
76
Miscellaneous Functions
77
Testing Input with Built-In Functions
77
Chapter 6. Writing Subroutines and Functions
79
What Are Subroutines and Functions
79
When to Write Subroutines Rather than Functions
79
Writing Subroutines and Functions
80
When to Use Internal Versus External Subroutines or Functions
82
Passing Information
82
Receiving Information from a Subroutine or Function
88
Subroutines and Functions-Similarities and Differences
92
Chapter 7. Manipulating Data
93
Using Compound Variables and Stems
93
What Is a Compound Variable
93
Using Stems
94
Parsing Data
95
Parsing Instructions
95
More about Parsing into Words
97
Parsing with Patterns
97
Parsing Multiple Strings as Arguments
100
Chapter 8. Using Commands from a Program
103
Types of Commands
103
Using Quotations Marks in Commands
103
Using Variables in Commands
103
Calling Another REXX Program as a Command
104
Issuing Commands from a Program
104
What Is a Host Command Environment
104
How Is a Command Passed to the Host Environment
105
Changing the Host Command Environment
105
Chapter 9. Diagnosing Problems Within a Program
107
Debugging Programs
107
Tracing Commands with the TRACE Instruction
107
Using REXX Special Variables RC and SIGL
107
Tracing with the Interactive Debug Facility
108
Saving Interactive TRACE Output
109
Chapter 10. Programming Style and Techniques
111
Consider the Data
111
Test Yourself
111
Happy Hour
112
Designing a Program
114
Methods for Designing Loops
115
The Conclusion
115
What Do We Have so Far
116
Stepwise Refinement: an Example
116
Reconsider the Data
117
Correcting Your Program
117
Modifying Your Program
117
Tracing Your Program
117
Coding Style
118
Part 2. Reference
123
Chapter 11. Introduction
125
Who Should Read this Reference
125
How to Use this Reference
125
Overview of Product Features
126
SAA Level 2 REXX Language Support under REXX/CICS
126
Support for the Interpretive Execution of REXX Execs
126
CICS-Based Text Editor for REXX Execs and Data
126
VSAM-Based File System for REXX Execs and Data
126
VSE Librarian Sublibraries
126
Dynamic Support for EXEC CICS Commands
127
REXX Interface to CEDA and CEMT Transaction Programs
127
High-Level Client/Server Support
127
Support for Commands Written in REXX
127
Command Definition of REXX Commands
127
Support for System and User Profile Execs
127
Shared Execs in Virtual Storage
127
SQL Interface
128
How to Read the Syntax Diagrams
128
Chapter 12. REXX General Concepts
131
Structure and General Syntax
131
Characters
132
Comments
132
Tokens
133
Implied Semicolons
136
Continuations
137
Expressions and Operators
137
Expressions
137
Operators
137
Parentheses and Operator Precedence
140
Clauses and Instructions
142
Null Clauses
142
Labels
142
Instructions
142
Assignments
142
Keyword Instructions
142
Commands
142
Assignments and Symbols
143
Constant Symbols
143
Simple Symbols
144
Compound Symbols
144
Stems
145
Commands to External Environments
146
Environment
146
Commands
146
Basic Structure of REXX Running under CICS
147
REXX Exec Invocation
147
Where Execs Execute
148
Locating and Loading Execs
148
Editing Execs
148
REXX File System
149
Control of Exec Execution Search Order
149
Adding User Written Commands
149
Support of Standard REXX Features
149
SAY and TRACE Statements
149
PULL and PARSE EXTERNAL Statements
149
REXX Stack Support
149
REXX Function Support
149
REXX Command Environment Support
150
Adding REXX Host Command Environments
150
Support of Standard CICS Features/Facilities
150
CICS Mapped I/O Support
150
Dataset I/O Services
150
Interfaces to CICS Facilities and Services
150
Issuing User Applications from Execs
150
REXX Interfaces to CICS Storage Queues
150
Pseudo-Conversational Transaction Support
151
Interfaces to Other Programming Languages
151
DBCS Support
151
Miscellaneous Features
151
Chapter 13. Keyword Instructions
153
Address
154
Arg
156
Call
157
Drop
164
Exit
165
Interpret
167
Iterate
169
Leave
170
Nop
171
Numeric
172
Options
173
Parse
174
Procedure
177
Pull
180
Push
181
Queue
182
Return
183
Say
184
Select
185
Signal
186
Trace
188
Upper
192
Chapter 14. Functions
193
Syntax
193
Functions and Subroutines
193
Search Order
194
Errors During Execution
195
Built-In Functions
196
ABBREV (Abbreviation)
197
ABS (Absolute Value)
197
Address
197
ARG (Argument)
197
BITAND (Bit by Bit AND)
198
BITOR (Bit by Bit OR)
199
BITXOR (Bit by Bit Exclusive OR)
199
B2X (Binary to Hexadecimal)
199
Center/Centre
200
Compare
200
Condition
200
Copies
201
C2D (Character to Decimal)
201
C2X (Character to Hexadecimal)
202
Datatype
202
Date
203
DBCS (Double-Byte Character Set Functions)
205
DELSTR (Delete String)
205
DELWORD (Delete Word)
205
Digits
205
D2C (Decimal to Character)
205
D2X (Decimal to Hexadecimal)
206
Errortext
206
Externals
207
Find
207
Form
207
Format
207
Fuzz
208
Index
209
Insert
209
Justify
209
LASTPOS (Last Position)
210
Left
210
Length
210
Linesize
210
MAX (Maximum)
210
MIN (Minimum)
211
Overlay
211
POS (Position)
211
Queued
212
Random
212
Reverse
213
Right
213
Sign
213
Sourceline
213
Space
213
Storage
214
Strip
214
SUBSTR (Substring)
214
Subword
215
Symbol
215
Time
215
Trace
217
Translate
217
TRUNC (Truncate)
217
Userid
218
Value
218
Verify
219
Word
219
Wordindex
220
Wordlength
220
WORDPOS (Word Position)
220
Words
220
XRANGE (Hexadecimal Range)
220
X2B (Hexadecimal to Binary)
221
X2C (Hexadecimal to Character)
221
X2D (Hexadecimal to Decimal)
221
External Functions Provided in REXX/CICS
222
Storage
222
Syssba
223
Chapter 15. Parsing
225
General Description
225
Simple Templates for Parsing into Words
225
Templates Containing String Patterns
227
Templates Containing Positional (Numeric) Patterns
228
Parsing with Variable Patterns
231
Using UPPER
231
Parsing Instructions Summary
232
Parsing Instructions Examples
232
Advanced Topics in Parsing
233
Parsing Multiple Strings
233
Combining String and Positional Patterns: a Special Case
234
Parsing with DBCS Characters
235
Details of Steps in Parsing
235
Chapter 16. Numbers and Arithmetic
239
Introduction
239
Definition
240
Numbers
240
Precision
240
Arithmetic Operators
240
Arithmetic Operation Rules-Basic Operators
241
Arithmetic Operation Rules-Additional Operators
242
Numeric Comparisons
244
Exponential Notation
244
Numeric Information
246
Whole Numbers
246
Numbers Used Directly by REXX
246
Errors
246
Chapter 17. Conditions and Condition Traps
247
Action Taken When a Condition Is Not Trapped
248
Action Taken When a Condition Is Trapped
248
Condition Information
250
Descriptive Strings
250
Special Variables
250
The Special Variable RC
250
The Special Variable SIGL
250
Chapter 18. REXX/CICS Text Editor
253
Invocation
253
Screen Format
254
Prefix Commands
254
Individual Line Commands
254
Consecutive Block Commands
255
Destination Commands
255
Macros under the REXX/CICS Editor
255
Command Line Commands
256
Arbchar
256
Args
256
Backward
257
Bottom
257
Cancel
258
Case
258
Change
259
Cmdline
259
Ctlchar
260
Curline
260
Display
261
Down
261
Edit
262
Exec
263
File
263
Find
264
Forward
265
Get
265
Getlib
265
Input
266
Join
266
Left
267
Lineadd
267
Lprefix
267
Macro
268
Msgline
268
Nulls
269
Numbers
269
Pfkey
270
Pfkline
270
Qquit
271
Query
271
Quit
272
Reserved
273
Reset
273
Right
273
Save
274
Sort
274
Split
275
Strip
275
Synonym
276
Top
276
Trunc
276
Return Codes
277
Chapter 19. REXX/CICS File System
279
File Pools, Directories, and Files
279
Current Directory and Path
280
Security
281
RFS Commands
281
Auth
281
Ckdir
282
Ckfile
282
Copy
283
Delete
283
Diskr
283
Diskw
284
Getdir
284
Mkdir
285
Rdir
285
Rename
286
File List Utility
286
Invocation
286
Macros under the REXX/CICS File List Utility
287
FLST Commands
287
Cancel
287
Copy
288
Delete
289
Down
289
End
289
Exec
289
Flst
290
Macro
291
Pfkey
291
Refresh
292
Rename
292
Sort
293
Synonym
293
FLST Return Codes
294
Running Execs and Transactions from FLST
294
Chapter 20. REXX/CICS List System
295
Directories and Lists
295
Current Directory and Path
296
Security
296
RLS Commands
297
Ckdir
297
Delete
297
Lpull
297
Lpush
298
Lqueue
299
Mkdir
299
Read
299
Vardrop
300
Varget
300
Varput
301
Write
301
Chapter 21. REXX/CICS Command Definition
303
Background
303
Highlights
303
Accomplishing Command Definition
303
Command Arguments Passed to REXX Programs
304
Command Arguments Passed to Assembler Programs
304
CICPARMS Control Block
305
Non-REXX Language Interfaces
306
CICGETV - Call to Get, Set, or Drop a REXX Variable
306
Operands
306
Notes
306
Chapter 22. REXX/CICS DB2 Interface
307
Programming Considerations
307
Embedding SQL Statements
307
Receiving the Results
309
Using the SQL Communications Area
310
Example Using SQL Statements
310
Chapter 23. REXX/CICS High-Level Client/Server Support
313
Overview
313
High-Level, Natural, Transparent REXX Client Interface
313
Support for REXX-Based Application Clients and Servers
313
Value of REXX in Client/Server Computing
313
REXX/CICS Client Exec Example
314
REXX/CICS Server Exec Example
315
Chapter 24. REXX/CICS Panel Facility
317
Facility
317
Example of Panel Definition
317
Defining Panels
318
Defining the Field Control Characters with the '.DEFINE' Verb
318
Define
319
Default Field Control Characters
319
Operands
320
Options
320
Defining the Actual PANEL Layout with the '.PANEL' Verb
321
Panel
322
Operands
323
Panel Generation and Panel Input/Output
323
Panel Runtime
324
Operands
325
Options
326
PANEL Variables
327
Panel Facility Return Code Information
328
Return Codes
329
System Error Reason Codes
329
Programmer Introduced Warning/Error Reason Codes
329
State Codes and Input Codes
330
Location Codes
332
Examples of Sample Panels
332
Example 1
332
Example 2
333
Example 3
333
Example 4
334
Example 5
334
Example of a REXX Panel Program
334
Panel Facility
335
Chapter 25. REXX/CICS Commands
341
Authuser
342
Operands
342
Return Codes
342
Example
342
Notes
342
Operands
343
Return Codes
343
Examples
343
Note
343
Ceda
345
Operands
345
Return Codes
345
Example
345
Cemt
346
Operands
346
Return Codes
346
Example
346
Cld
347
Operands
347
Return Codes
347
Examples
347
Notes
347
Convtmap
348
Operands
348
Return Codes
348
Example
348
Copyr2S
349
Operands
349
Return Codes
350
Examples
350
Copys2R
351
Operands
351
Return Codes
352
Example
352
Notes
352
C2S
353
Operands
353
Return Codes
353
Example
353
Notes
353
Defcmd
354
Operands
354
Return Codes
355
Example
355
Notes
355
Defscmd
357
Operands
357
Return Codes
358
Example
358
Notes
358
Deftrnid
360
Operands
360
Return Codes
360
Example
360
Notes
360
Dir
361
Operands
361
Return Codes
361
Examples
361
Note
361
Edit
362
Operands
362
Return Codes
362
Example
362
Note
362
Exec
363
Operands
363
Return Codes
363
Example
363
Execdrop
364
Operands
364
Return Codes
364
Example
364
Note
365
Execio
366
Operands
366
Return Codes
366
Examples
366
Notes
366
Execload
368
Operands
368
Return Codes
368
Example
369
Notes
369
Execmap
370
Return Codes
370
Example
370
Export
371
Operands
371
Return Codes
371
Example
371
Notes
371
Filepool
372
Operands
372
Return Codes
372
Example
373
Note
373
Flst
374
Operands
374
Return Codes
374
Example
374
Notes
374
Getvers
375
Return Codes
375
Example
375
Help
376
Operands
376
Return Codes
376
Import
377
Operands
377
Return Codes
377
Example
377
Listcmd
378
Operands
378
Return Codes
378
Example
378
Listclib
379
Operands
379
Return Codes
379
Example
379
Listelib
380
Operands
380
Return Codes
380
Example
380
Listpool
381
Operands
381
Return Codes
381
Example
381
Note
381
Listtrnid
382
Return Codes
382
Example
382
Path
383
Operands
383
Return Codes
383
Examples
383
Notes
383
Pseudo
384
Operands
384
Return Codes
384
Example
384
Note
384
Rfs
385
Operands
385
Return Codes
386
Note
387
Rls
388
Operands
388
Return Codes
389
Scrninfo
390
Return Codes
390
Example
390
Notes
390
Set
391
Operands
391
Return Codes
392
Example
392
Notes
392
Setsys
393
Operands
393
Return Codes
394
Example
394
S2C
395
Operands
395
Return Codes
395
Example
395
Notes
395
Termid
396
Return Codes
396
Example
396
Waitread
397
Return Codes
397
Example
397
Note
397
Waitreq
398
Return Codes
398
Example
398
Part 3. Appendixes
399
Appendix A. Error Numbers and Messages
401
Appendix B. Return Codes
409
Panel Facility
409
Sql
409
RFS and FLST
409
EDITOR and EDIT
409
Dir
410
Set
410
Path
410
Rls
410
Listcmd
411
Cld
411
Defcmd
411
Defscmd
411
Deftrnid
412
Execdrop
412
Execload
412
Execmap
412
EXPORT and IMPORT
412
Filepool
412
LISTCLIB and LISTELIB
413
Getvers
413
Copyr2S
413
Copys2R
413
Listpool
413
Listtrnid
414
C2S
414
Pseudo
414
Authuser
414
Setsys
414
S2C
414
Termid
414
Waitread
414
Waitreq
415
Exec
415
CEDA and CEMT
415
Execio
415
Convtmap
415
Scrninfo
415
Cics
415
Appendix C. Double-Byte Character Set (DBCS) Support
417
General Description
417
Enabling DBCS Data Operations and Symbol Use
418
Symbols and Strings
418
Validation
419
Instruction Examples
419
DBCS Function Handling
421
Built-In Function Examples
422
DBCS Processing Functions
426
Counting Option
426
Function Descriptions
426
Dbadjust
426
Dbbracket
426
Dbcenter
427
Dbcjustify
427
Dbleft
427
Dbright
428
Dbrleft
428
Dbrright
428
Dbtodbcs
429
Dbtosbcs
429
Dbunbracket
429
Dbvalidate
430
Dbwidth
430
Appendix D. Reserved Keywords and Special Variables
431
Reserved Keywords
431
Special Variables
431
Appendix E. Debug Aids
433
Interactive Debugging of Programs
433
Interrupting Execution and Controlling Tracing
434
Appendix F. REXX/CICS Business Value Discussion
435
Business Solutions
435
Product Positioning
437
Appendix G. System Definition/Customization/Administration
439
Authorized REXX/CICS Commands/Authorized Command Options
439
System Profile Exec
439
Authorized REXX/CICS VSE Librarian Sublibraries
439
Defining Authorized Users
439
Setting System Options
440
Defining and Initializing a REXX File System (RFS) File Pool
440
Adding Files to a REXX File System (RFS) File Pool
440
RFS File Sharing Authorization
440
Creating a PLT Entry for CICSTART
440
Security Exit
440
Cicsecx2
440
Appendix H. Security
443
REXX/CICS Supports Multiple Transaction Identifiers
443
REXX/CICS File Security
443
ESA/VSE Command Level Security
443
REXX/CICS Authorized Command Support
443
Security Definitions
444
REXX/CICS General Users
444
REXX/CICS Authorized Users
444
REXX/CICS Authorized Commands
444
REXX/CICS Authorized Execs
444
REXX/CICS System Sublibraries
444
Appendix I. Performance Considerations
447
Appendix J. Basic Mapping Support Example
449
Appendix K. Post-Installation Configuration
453
Create the RFS Filepools
453
Install Resource Definitions
453
Update LSRPOOL Definitions
453
Rename Supplied Procedures
453
Update CICSTART.PROC
454
Update CICS Initialization JCL
454
Format the RFS Filepools
455
Create the Help Files
455
Verify the Installation
456
Configure the REXX DB2 Interface
457
Bibliography
459
CICS Transaction Server for VSE/ESA Release 1 Library
459
Where to Find more Information
460
Books from VSE/ESA 2.5 Base Program Libraries
460
VSE/ESA Version 2 Release 5
460
High-Level Assembler Language (HLASM)
461
Language Environment for VSE/ESA (LE/VSE)
461
Vse/Iccf
461
Vse/Power
461
Vse/Vsam
461
VTAM for VSE/ESA
461
Books from VSE/ESA 2.5 Optional Program Libraries
462
C for VSE/ESA (C/VSE)
462
COBOL for VSE/ESA (COBOL/VSE)
462
DB2 Server for VSE
462
Dl/I Vse
463
PL/I for VSE/ESA (PL/I VSE)
463
Screen Definition Facility II (SDF II)
463
Notices
465
Trademarks
467
Index
469
Sending Your Comments to IBM
477
Advertisement
Advertisement
Related Products
IBM ThinkPad R30
IBM ThinkPad R31
IBM Rational Rose 7.0.0
IBM Redbooks System x3550 M4
IBM Redbooks ServeRAID
IBM Redbooks ServeRAID II
IBM Redbooks ServeRAID 8e
IBM Redbooks SAS HBA Controller
IBM Redbooks System x3400 M3
IBM R/S6000 7012 380
IBM Categories
Server
Desktop
Storage
Laptop
Monitor
More IBM Manuals
Login
Sign In
OR
Sign in with Facebook
Sign in with Google
Upload manual
Upload from disk
Upload from URL