Manuali utente per IBM SC34-5764-01

Sommario

• Contents

  5
• Preface

  21
  • What this book is about

    21
  • Who this book is for

    21
  • What you need to know to understand this book

    21
    • Prerequisites

      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
      • Using Quotation Marks in an Instruction

        28
      • Ending an instruction

        29
      • Continuing an instruction

        29
      • Continuing a literal string without adding a space

        30
    • Types of REXX Clauses

      31
      • Keyword Instructions

        31
      • Assignment

        31
      • Label

        32
      • Null Clause

        32
      • Commands

        32
  • 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
      • Specifying Too Few Values

        37
      • Specifying Too Many Values

        37
    • Preventing Translation of Input to Uppercase

      38
      • Exercises - Using the ARG Instruction

        38
    • Passing Arguments

      39
      • Using the CALL Instruction or a REXX Function Call

        39
• Chapter 3. Using Variables and Expressions

  41
  • Program Variables

    41
  • Using Variables

    41
    • Variable Names

      41
    • Variable Values

      42
      • Exercises - Identifying Valid Variable Names

        42
  • Using Expressions

    43
    • Arithmetic Operators

      43
      • Division

        44
      • Order of Evaluation

        44
      • Using Arithmetic Expressions

        45
      • Exercises—Calculating Arithmetic Expressions

        45
    • Comparison Operators

      45
      • The Strictly Equal and Equal Operators

        46
      • Using Comparison Expressions

        46
      • Exercises - Using Comparison Expressions

        47
    • Logical (Boolean) Operators

      47
      • Using Logical Expressions

        48
      • Exercises - Using Logical Expressions

        49
    • Concatenation Operators

      49
      • Using Concatenation Operators

        49
    • Priority of Operators

      50
      • Exercises - Priority of Operators

        51
  • 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...THEN...ELSE Instructions

      56
      • Exercise - Using the IF...THEN...ELSE Instruction

        58
    • SELECT WHEN...OTHERWISE...END Instruction

      59
      • Exercises - Using SELECT WHEN...OTHERWISE...END

        60
  • Using Looping Instructions

    61
    • Repetitive Loops

      61
      • Infinite Loops

        62
      • DO FOREVER Loops

        62
      • LEAVE Instruction

        63
      • ITERATE Instruction

        63
      • Exercises - Using Loops

        64
    • Conditional Loops

      64
      • DO WHILE Loops

        65
      • Exercise - Using a DO WHILE Loop

        65
      • DO UNTIL Loops

        66
      • Exercise - Using a DO UNTIL Loop

        67
    • Combining Types of Loops

      68
    • Nested DO Loops

      68
      • Exercises - Combining Loops

        69
  • 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
      • Exercise - Writing a program with Built-In Functions

        78
• 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
      • Passing Information by Using Variables

        82
      • Passing Information by Using Arguments

        86
    • Receiving Information from a Subroutine or Function

      88
      • Exercise - Writing an Internal and an External Subroutine

        89
      • Exercise - Writing a Function

        90
  • 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
      • Exercises - Using Compound Variables and Stems

        94
  • Parsing Data

    95
    • Parsing Instructions

      95
      • PULL Instruction

        95
      • ARG Instruction

        96
      • PARSE VALUE ... WITH Instruction

        96
      • PARSE VAR Instruction

        96
    • More about Parsing into Words

      97
    • Parsing with Patterns

      97
      • String

        98
      • Variable

        98
      • Number

        98
    • Parsing Multiple Strings as Arguments

      100
      • Exercise - Practice with Parsing

        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
      • Calling Another Program with the EXEC 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
      • Determining the Active Host Command Environment

        105
• Chapter 9. Diagnosing Problems within a program

  107
  • Debugging Programs

    107
    • Tracing Commands with the TRACE Instruction

      107
      • TRACE C

        107
      • TRACE E

        107
    • Using REXX Special Variables RC and SIGL

      107
      • RC

        107
      • SIGL

        108
    • Tracing with the Interactive Debug Facility

      108
      • Starting Interactive Debug

        108
      • Options within Interactive Debug

        108
      • Ending Interactive Debug

        109
    • Saving Interactive TRACE Output

      109
• Chapter 10. Programming Style and Techniques

  111
  • Consider the Data

    111
    • Test Yourself...

      111
      • Answer:

        112
  • 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
      • Programming Considerations

        128
      • Embedding SQL statments

        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
      • String Concatenation

        138
      • Arithmetic

        138
      • Comparison

        139
      • Logical (Boolean)

        140
    • 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
  • DO

    160
  • DROP

    164
  • EXIT

    165
  • IF

    166
  • 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
      • The Period as a Placeholder

        226
    • Templates Containing String Patterns

      227
    • Templates Containing Positional (Numeric) Patterns

      228
      • Combining Patterns and Parsing Into Words

        230
    • 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
      • Addition and Subtraction

        241
      • Multiplication

        241
      • Division

        242
      • Basic Operator Examples

        242
    • Arithmetic Operation Rules—Additional Operators

      242
      • Power

        242
      • Integer Division

        243
      • Remainder

        243
      • Additional Operator Examples

        243
    • 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
      • Operands

        256
      • Return Codes

        256
      • Example

        256
      • Note

        256
    • ARGS

      256
      • Operands

        257
      • Return Codes

        257
      • Example

        257
    • BACKWARD

      257
      • Operands

        257
      • Return Codes

        257
      • Example

        257
      • Note

        257
    • BOTTOM

      257
      • Return Codes

        258
      • Example

        258
    • CANCEL

      258
      • Return Codes

        258
      • Example

        258
      • Notes

        258
    • CASE

      258
      • Operands

        258
      • Return Codes

        259
      • Example

        259
    • CHANGE

      259
      • Operands

        259
      • Return Codes

        259
      • Example

        259
      • Note

        259
    • CMDLINE

      259
      • Operands

        259
      • Return Codes

        260
      • Example

        260
    • CTLCHAR

      260
      • Operands

        260
      • Return Codes

        260
      • Example

        260
    • CURLINE

      260
      • Operands

        261
      • Return Codes

        261
      • Example

        261
      • Note

        261
    • DISPLAY

      261
      • Return Codes

        261
      • Example

        261
      • Note

        261
    • DOWN

      261
      • Operands

        261
      • Return Codes

        261
      • Example

        262
    • EDIT

      262
      • Operands

        262
      • Return Codes

        262
      • Example

        262
      • Notes

        262
    • EXEC

      263
      • Operands

        263
      • Return Codes

        263
      • Example

        263
    • FILE

      263
      • Operands

        264
      • Return Codes

        264
      • Example

        264
    • FIND

      264
      • Operands

        264
      • Return Codes

        264
      • Examples

        264
      • Notes

        264
    • FORWARD

      265
      • Operands

        265
      • Return Codes

        265
      • Example

        265
      • Note

        265
    • GET

      265
      • Operands

        265
      • Return Codes

        265
      • Example

        265
    • GETLIB

      265
      • Operands

        266
      • Return Codes

        266
      • Example

        266
    • INPUT

      266
      • Operands

        266
      • Return Codes

        266
      • Example

        266
    • JOIN

      266
      • Return Codes

        266
      • Example

        267
    • LEFT

      267
      • Operands

        267
      • Return Codes

        267
      • Example

        267
    • LINEADD

      267
      • Return Codes

        267
      • Example

        267
      • Note

        267
    • LPREFIX

      267
      • Operands

        268
      • Return Codes

        268
      • Example

        268
      • Note

        268
    • MACRO

      268
      • Operands

        268
      • Return Codes

        268
      • Example

        268
      • Note

        268
    • MSGLINE

      268
      • Operands

        269
      • Return Codes

        269
      • Example

        269
    • NULLS

      269
      • Operands

        269
      • Return Codes

        269
      • Example

        269
    • NUMBERS

      269
      • Operands

        269
      • Return Codes

        270
      • Example

        270
      • Note

        270
    • PFKEY

      270
      • Operands

        270
      • Return Codes

        270
      • Example

        270
    • PFKLINE

      270
      • Operands

        270
      • Return Codes

        271
      • Example

        271
    • QQUIT

      271
      • Return Codes

        271
      • Example

        271
      • Notes

        271
    • QUERY

      271
      • Operands

        271
      • Return Codes

        272
      • Example

        272
    • QUIT

      272
      • Return Codes

        272
      • Example

        272
      • Note

        273
    • RESERVED

      273
      • Operands

        273
      • Return Codes

        273
      • Example

        273
    • RESET

      273
      • Return Codes

        273
      • Example

        273
    • RIGHT

      273
      • Operands

        274
      • Return Codes

        274
      • Example

        274
      • Note

        274
    • SAVE

      274
      • Operands

        274
      • Return Codes

        274
      • Example

        274
    • SORT

      274
      • Operands

        275
      • Return Codes

        275
      • Example

        275
      • Note

        275
    • SPLIT

      275
      • Return Codes

        275
      • Example

        275
    • STRIP

      275
      • Return Codes

        276
      • Example

        276
    • SYNONYM

      276
      • Operands

        276
      • Return Codes

        276
      • Example

        276
    • TOP

      276
      • Return Codes

        276
      • Example

        276
    • TRUNC

      276
      • Operands

        277
      • Return Codes

        277
      • Example

        277
      • Note

        277
    • UP

      277
      • Operands

        277
      • Return Codes

        277
      • Example

        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
      • Operands

        282
      • Return Codes

        282
      • Example

        282
    • CKDIR

      282
      • Operands

        282
      • Return Codes

        282
      • Example

        282
    • CKFILE

      282
      • Operands

        282
      • Return Codes

        283
      • Example

        283
    • COPY

      283
      • Operands

        283
      • Return Codes

        283
      • Example

        283
    • DELETE

      283
      • Operands

        283
      • Return Codes

        283
      • Example

        283
    • DISKR

      283
      • Operands

        284
      • Return Codes

        284
      • Example

        284
      • Note

        284
    • DISKW

      284
      • Operands

        284
      • Return Codes

        284
      • Example

        284
      • Note

        284
    • GETDIR

      284
      • Operands

        285
      • Return Codes

        285
      • Example

        285
    • MKDIR

      285
      • Operands

        285
      • Return Codes

        285
      • Example

        285
      • Note

        285
    • RDIR

      285
      • Operands

        285
      • Return Codes

        285
      • Example

        286
    • RENAME

      286
      • Operands

        286
      • Return Codes

        286
      • Example

        286
  • File List Utility

    286
    • Invocation

      286
  • Macros under the REXX/CICS File List Utility

    287
  • FLST Commands

    287
    • CANCEL

      287
    • CD

      288
      • Operands

        288
      • Example

        288
    • COPY

      288
      • Operands

        288
      • Example

        288
      • Operands

        288
      • Example

        288
    • DELETE

      289
      • Operands

        289
      • Example

        289
    • DOWN

      289
      • Operands

        289
      • Example

        289
    • END

      289
    • EXEC

      289
      • Operands

        290
      • Example

        290
      • Operands

        290
      • Return Codes

        290
      • Example

        290
    • FLST

      290
      • Operands

        290
      • Example

        290
      • Note

        291
    • MACRO

      291
      • Operands

        291
      • Return Codes

        291
      • Example

        291
      • Note

        291
    • PFKEY

      291
      • Operands

        291
      • Example

        291
      • Note

        292
    • REFRESH

      292
      • Example

        292
    • RENAME

      292
      • Operands

        292
      • Example

        292
      • Operands

        292
      • Example

        292
    • SORT

      293
      • Operands

        293
      • Example

        293
    • SYNONYM

      293
      • Operands

        293
      • Example

        294
    • UP

      294
      • Operands

        294
      • Example

        294
  • 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
      • Operands

        297
      • Return Codes

        297
      • Example

        297
    • DELETE

      297
      • Operands

        297
      • Return Codes

        297
      • Example

        297
    • LPULL

      297
      • Operands

        298
      • Return Codes

        298
      • Example

        298
    • LPUSH

      298
      • Operands

        298
      • Return Codes

        298
      • Example

        298
    • LQUEUE

      299
      • Operands

        299
      • Return Codes

        299
      • Example

        299
    • MKDIR

      299
      • Operands

        299
      • Return Codes

        299
      • Example

        299
    • READ

      299
      • Operands

        300
      • Return Codes

        300
      • Example

        300
      • Note

        300
    • VARDROP

      300
      • Operands

        300
      • Return Codes

        300
      • Example

        300
    • VARGET

      300
      • Operands

        301
      • Return Codes

        301
      • Example

        301
    • VARPUT

      301
      • Operands

        301
      • Return Codes

        301
      • Example

        301
    • WRITE

      301
      • Operands

        301
      • Return Codes

        302
      • Example

        302
      • Note

        302
• 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
      • State codes

        330
      • State codes

        331
      • Input codes

        331
      • State Codes

        332
      • Input codes

        332
    • 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
• Chapter 25. REXX/CICS Commands

  341
  • AUTHUSER

    342
    • Operands

      342
    • Return Codes

      342
    • Example

      342
    • Notes

      342
  • CD

    343
    • 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
  • CD

    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
      • DBCS-Only Symbols and Mixed SBCS/DBCS Symbols

        418
      • DBCS-Only Strings and Mixed SBCS/DBCS Strings

        418
    • Validation

      419
      • DBCS Symbol Validation

        419
      • Mixed String Validation

        419
    • Instruction Examples

      419
      • PARSE

        420
      • PUSH and QUEUE

        420
      • SAY and TRACE

        420
      • UPPER

        421
  • DBCS Function Handling

    421
    • Built-in Function Examples

      422
      • ABBREV

        422
      • COMPARE

        422
      • COPIES

        422
      • DATATYPE

        423
      • FIND

        423
      • INDEX, POS, and LASTPOS

        423
      • INSERT and OVERLAY

        423
      • JUSTIFY

        423
      • LEFT, RIGHT, and CENTER

        423
      • LENGTH

        424
      • REVERSE

        424
      • SPACE

        424
      • STRIP

        424
      • SUBSTR and DELSTR

        424
      • SUBWORD and DELWORD

        424
      • SYMBOL

        424
      • TRANSLATE

        425
      • VALUE

        425
      • VERIFY

        425
      • WORD, WORDINDEX, and WORDLENGTH

        425
      • WORDS

        425
      • WORDPOS

        426
  • 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
      • Parameters

        440
      • Return Codes

        440
      • Function IDs

        441
• 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
  • Special characters

    469
  • A

    469
  • B

    469
  • C

    469
  • D

    470
  • E

    470
  • F

    472
  • G

    472
  • H

    472
  • I

    472
  • J

    472
  • L

    472
  • M

    473
  • N

    473
  • O

    473
  • P

    473
  • Q

    473
  • R

    474
  • S

    474
  • T

    475
  • U

    475
  • V

    475
  • W

    475
  • X

    475
  • Y

    475
• Sending your comments to IBM

  477