Index. IBM Version 8.5
Tangazo
Tangazo
Index
Special characters
%PROCESS statement
specifying compile-time options with 25
A
access methods
accessing data sets
adapting existing programs for workstation VSAM 294
adding or replacing objects in a library,
aggregate
ALIGNED compile-time suboption 46
American National Standard Institute
(ANSI)
ANS
ANSI
control character 234, 255 print control characters 255
application program coding SQL statements
AREAs and INITIAL attribute 11
array expressions restrictions 5
ASCII compile-time suboption
ASSIGNABLE compile-time suboption 46
attributes and cross-reference table 180
© Copyright IBM Corp. 1998, 2012
avoiding calls to library routines 366
B
base file of VSAM keyed data set 287
built-in functions
BYADDR
description 358 effect on performance 358
BYVALUE
description 358 effect on performance 358
C
call interface conventions
general-purpose register implications
examples of passing parameters 397 parameters 397
carriage return-line feed (CR - LF) 246
CEE.OPTIONS environment variable 207
CICS
coding
command line parameters for ILIB 383
command line, setting run-time options 207
comparing dates
using literals 487 using non-literals 487
with differing patterns 486 with like patterns 485, 486
compatibility of PL/I for z/OS files for the workstation 294
compilation
environment variables
mainframe applications on your workstation 3
preparing your source program 18
user exit
using the PLI command to invoke the compiler 24
compilation output
using the compiler listing 175
compiler
listing
compiler options
515
compiler options
(continued)
516
PL/I for Windows Programming Guide compiler options
(continued)
compiler restrictions
array expressions 5 built-in functions 5
DEFAULT statement 5 extents of automatic variables 5
condition handling
general concepts 219 interrupts 219
list of conditions and their attributes 222 qualified and unqualified conditions 222
scope and descendancy 219 terminology 219
conditions
handling conversions inline 366
handling string built-in functions inline 367
CONNECTED compile-time suboption
CONSECUTIVE
option
consecutive data sets controlling input from the terminal
capital and lowercase letters 267 end of file 267
using files conversationally 266
controlling output to the terminal
example of an interactive program 268 format of PRINT files 268 stream and record files 268
consecutive data sets
(continued)
using record-oriented I/O
accessing and updating a data set 271 creating a data set 271
ENVIRONMENT options for data transmission 271
using stream-oriented data transmission
accessing a data set with stream
creating a data set with stream
using SYSIN and SYSPRINT files 265
control blocks
control characters
cross-reference table in compilation output 180
CURRENCY compile time option
customizing
setting compile-time environment variables 21
user exit
structure of global control blocks 372 writing your own compiler exit 372
D
data
files
OPEN 250 closing a PL/I file 250 creating 250
record 232 remote file access 232
representations, portability 7
types
data set
VSAM
workstation VSAM
data sets
accessing
associating a PL/I file with a data set
using environment variables 248
combinations of I/O statements, attributes, and options 251
variable 239, 248 default identification 248
DISPLAY statement input and output 253
establishing characteristics
DD:ddname environment variable 239
PL/I ENVIRONMENT attribute 233 record formats 233
organization
PL/I standard files (SYSPRINT and
redirecting standard input
specifying characteristics 232
types
conventional text files and devices 230 fixed-length data sets 230 native data sets 230
data sets
(continued)
workstation VSAM
data-directed I/O
DBCS constants 236 specifying GRAPHIC option 236
DATE attribute
DAYSTODATE built-in function 485
DBCS (double-byte character set)
DD information
DD:ddname environment variables 239
specifying characteristics 239
DDM data sets
debugging programs common PL/I errors
compiler or library subroutine failure 225
invalid use of PL/I 222 logical errors in source 222
loops and other unforeseen errors 223
unexpected input/output data 224
unexpected program results 225
unexpected program termination 224
uninitialized entry variables 223
debugging programs
(continued)
using compile-time options 213
using footprints for debugging
DECLARE
declaring
host variables, SQL preprocessor 161
DEF files
DEFAULT compile-time option suboptions
suboptions
Index
517
DEFAULT statement restrictions 5
DEFINED
defining files
definition file
DELAY option
DELIMIT option
DEPRECATENEXT compiler option 55
DESCLIST compile-time suboption 47
DESCLOCATOR compile-time suboption 47
DESCRIPTOR compile-time option
DESCRIPTOR compile-time suboption
device
DIRECT file
using to access a workstation VSAM direct data set 309
using to access a workstation VSAM keyed data set 302
Distributed Data Management 229
DPATH run-time environment variable 207
DRIVER sample program
example of FETCHing a DLL at run time 381
DRIVER1.DEF file
sample program to build a DLL 381
DRIVER1.PLI file
sample program that uses a DLL 381
DSNTIAR.PLI sample program 169
dummy
DUMMY compile-time suboption 48
dummy records
dumps
SNAP dumps for trace information 219
dynamic link libraries
compiling, linking, running 381
using FETCH and RELEASE in your main program 381
ERROR
error and condition handling
conditions used for testing and debugging 222
dynamic descendancy 219 general concepts 219 interrupts and PL/I conditions 219
E
EBCDIC
F
static descendancy 219 terminology 219
errors
calling uninitialized entry variables 223
embedded
embedded SQL
end of file characters (/*) 267
ENVIRONEMENT options not supported 4
ENVIRONMENT attribute
(REREAD) on the CLOSE statement
options
specifying characteristics 233
differences in issuing from PL/I for z/OS 12
invalid use of PL/I 222 logical errors in source program 222
unexpected
EVENDEC compile-time suboption 48
EXTDICTIONARY option for ILIB 393
specifying options
for workstation VSAM data sets 292
environment differences, S/390 and
ENVIRONMENT options for record-oriented data transmission
stream-oriented data transmission 257
environment variables
FETCH statement
using in your main program 381
files adapting existing programs for workstation VSAM
using CONSECUTIVE files 293 using INDEXED files 293
using REGIONAL(1) files 294 using VSAM files 294
declarations for REGIONAL(1) data sets 277
defining
PL/I
518
PL/I for Windows Programming Guide
FIXED
BINARY, mapping and portability 11
fixed-length record format 233
FLAG compile-time option
FLOATINMATH compiler option 60
FREEFORMAT option for ILIB 392
G
GENDEF (/gd) option for ILIB 392
general purpose register implications example
passing conforming parameters to a routine 398
passing floating point parameters to a routine 400
generating declare statements 323
GENIMPLIB (/gi) option for ILIB 392
GET statements
controlling input from the terminal 265
global control blocks
writing the initialization procedure 373 writing the message filtering procedure 373
writing the termination procedure 375
GONUMBER compile-time option
GONUMBER compiler option 61, 356
GRAPHIC
graphic data and stream I/O 256
H
handling conditions
built-in for condition handling 221
PL/I run-time error message formats 220
SNAP messages 221 system messages 221
HEXADECIMAL
host
variables, using in SQL statements 161
I
I/O access methods
IEEE
ILIB
ILINK environment variable 193
improving performance 355 improving application performance 355
INCLUDE
include files
include preprocessor
INDEXAREA ENVIRONMENT option 4
INDEXED files, adapting programs 293
INITFILL compile-time suboption 49
initialization procedure of compiler user exit 373
INLINE compile-time suboption 49
input
defining data sets for stream files 256
example of interactive program 268
to the terminal
example of an interactive program 268
input
(continued)
to the terminal
(continued)
format of PRINT files 268 stream and record files 268
input and output with workstation
VSAM data sets
organization
accessing records in 288 creating and accessing 288 determining which type you need 288
using workstation VSAM direct data sets
using a DIRECT file to access 309 using a SEQUENTIAL file to access 309
using workstation VSAM keyed data sets
using a DIRECT file to access 302 using a SEQUENTIAL file to access 302
using workstation VSAM sequential data sets
using a SEQUENTIAL file to access 296
input- and output-handling routines, sort program 441
Institute (ANSI)
interactive program, example 268
interlanguage communication (ILC) 411
invoking
J
Java 420, 421, 422, 423, 424, 425, 426,
Java code, compiling 421, 424, 429
Java code, writing 420, 423, 427
jni
JNI sample program 420, 423, 427
K
key
accessing a sequential data set 290
relative record number
KEY
keys for workstation VSAM keyed data sets 289
Index
519
KEY
(continued)
relative record numbers 290 sequential record values 290
keyboard
keyed data sets
statements and options for 298
KEYFROM, relative record numbers 290
keys
using for workstation VSAM keyed data sets 289
using relative record numbers 290 using sequential record values 290
KEYTO
keys for workstation VSAM keyed data sets 289
sequential file to access a workstation
L
large object (LOB) support, SQL preprocessor 167
length of record
library, compiler subroutine failure 225
line feed (LF)
delimiting logical records 230
LINE option
in controlling output to the terminal 268
using with PRINT files 261 when using PRINT files 261
LINESIZE option
accessing a data set with stream
I/O 257 creating a data set with stream
linkage
OPTLINK
SYSTEM
520
PL/I for Windows Programming Guide linkage
(continued)
SYSTEM
(continued)
LINKAGE compile-time suboption
linking your program creating files
dynamic link library 190 executable files 190
search rules 188 specifying directories 188
starting the linker 185 static linking 185
list-directed I/O
DBCS constants 236 specifying GRAPHIC option 236
loops
LOWERINC compile-time suboption 49
M
macro facility
macro preprocessor
mainframe applications
managing libraries (.LIB files) 383
messages
modifying in compiler user exit 371
migration
compatibility with PL/I for z/OS 3
migration
(continued)
PL/I for z/OS files for the workstation
Millennium Language Extensions
using in PL/I applications 481
mixed-language applications 411
N
named constants
defining 365 versus static variables 365
NATIVE compile-time suboption
native data sets
accessing 230 character devices 230 conventional text files 230
NATIVEADDR compile-time suboption 50
NATLANG
NMAKE utility
characters that modify commands 352
introduction 333 make file utility (NMAKE) 333
NOBIN1ARG compiler suboption 46
NODESCRIPTOR compile-time suboption 47
NOEVENDEC compile-time suboption 48
NOFREEFORMAT option for ILIB 392
NOINITFILL compile-time suboption 49
NOINLINE compile-time suboption 49
NOLAXDCL compile-time option 213
NOLAXIF compile-time option 213
NONASSIGNABLE compile-time suboption 46
NONCONNECTED compile-time suboption 47
NONNATIVE compile-time suboption 49
NONNATIVEADDR compile-time suboption 50
NONRECURSIVE compile-time suboption 51
NONULLSTRADDR compiler suboption 50
NOOVERLAP compile-time suboption
NOT compile time option
NULL370 compile-time suboption 50
NULLSTRADDR compiler suboption 50
NULLSTRPTR compiler suboption 50
NULLSYS compile-time suboption 50
NUMBER compile-time option 180
numeric arguments for the linker 194
O
driver manager 315 embedded SQL 315
environment-specific information 316
offset
determining statement numbers 221
Open Database Connectivity (see
OPEN statement
specifying the length of records 232
using
Operating system
data definition (DD) information 248
optimal coding
OPTIMIZE compiler option 99, 355
options compile-time
DD:ddname environment variables
output
(continued)
to the terminal
example of an interactive program 268 format of PRINT files 268 stream and record files 268
OVERLAP compile-time suboption
page
PL/I ENVIRONMENT attribute
PAGESIZE tab set table field 264
PAGE option
PATH run-time environment variable 207
performance improvement coding for performance
avoiding calls to library routines 366
DATA-directed input and output 361
named constants versus static variables 365
PRINT attribute
selecting compile-time options
run-time
using
OR compile time option
PL/I compiler
ORDER compile-time suboption
ORDINAL compile-time suboption 51
organization
output
defining data sets for stream files 256
P
ENVIRONMENT attribute
options portable to other SAA implementations 233
files
associating with a data set 248
preparing for compilation 18 structure 18
PL/I code, compiling 422, 426, 430
PL/I code, linking 422, 426, 430
PL/I code, writing 421, 425, 429
platform
PLI command
Index
521
PLI command
(continued)
specifying compile-time options 25
PLIDUMP
obtaining
reading a formatted PL/I dump 218
PLISRTx
determining which subroutine to use 434
input- and output-handling routines 441
sort data input and output 441
specifying the sorting field 437
portability
national characters and other symbols 3 operating system differences 3
PPTRACE compile-time option 108
using compile-time options 18 using the sample programs provided 18
PREFIX compile-time option
PREFIX compiler option 110, 357 using default suboptions 357
preparing your source program for compilation
line continuation 20 margins 20 program file format 20
preprocessors
macro facility 148 macro preprocessor 148
PRINT files
applying the PRINT attribute 261
controlling printed line length 262
inserting ANSI print control characters 261
overriding the tab control table 264
printer control character, ASA 255 printer-destined files 255
ANSI print control characters
IBM Proprinter equivalents 256
controlling printed line length 262
example of creating a file 263
overriding the tab control table 264
program file format
line continuation 20 margins 20
Proprinter, IBM, control characters 234
PSEUDODUMMY compile-time suboption 51
PUT
statement
controlling input from the terminal 266
PUT statement
PAGE, SKIP, and LINE options 255
Q
R
READ statement, attributes, and options 252
RECORD condition
adapting CONSECUTIVE file for workstation VSAM 293 adapting INDEXED file for workstation VSAM 293
RECORD I/O
522
PL/I for Windows Programming Guide
RECORD OUTPUT files
associated with consecutive data sets 234 using CTLASA 234
record-oriented I/O
accessing a data set 271 creating a data set 271
ENVIRONMENT options for data transmission 271
essential information 272 examples of consecutive data sets 272
records
accessing in workstation VSAM data sets 288
RECSIZE option
PL/I ENVIRONMENT attribute 237
specifying the length of records 232
RECURSIVE compile-time suboption 51
regional data sets
commands and options 277 description 277
file definition
specifying ENVIRONMENT options 279
using keys with regional data sets 280
using REGIONAL(1) data sets
sequential access 282 updating 282
REGIONAL(1) data sets
relative record numbers in workstation
RELEASE statement, example 381
REORDER compile-time suboption
RESPECT compiler option 117, 482
RETCODE compile-time suboption 51
RETURNS compile-time suboption 51,
REWRITE statement, attributes and options 253
routines, library, conversions 367
RULES compile-time option
RULES compiler option 118, 482
run-time messages
run-time options
NATLANG 208 specifying multiple run-time options or suboptions 208
where to specify run-time options 207
running your program
setting run-time environment variables 207 specifying run-time options 207
runtime behavior differences
INITIAL attribute for AREAs is ignored 11 language elements 11 using variables declared as FIXED
differences between platforms 7
S
sample program, running 423, 427, 431
screen and keyboard operations 253
search rules
sequential
data sets
record value
in workstation VSAM sequential data set 290
SEQUENTIAL
SEQUENTIAL file
using to access a workstation VSAM direct data set 309
using to access a workstation VSAM keyed data set 302
SEQUENTIAL file
(continued)
using to access a workstation VSAM sequential data set 296
SET command
run-time environment variables 207
SHORT compile-time suboption 51
SKIP option
controlling input from the terminal 267
SNAP compile-time option
sort exit
sort program
comparing S/390 to the workstation 433
input- and output-handling routines 441
sort data input and output 441
specifying the sorting field 437
specifying run-time options 207
SQL preprocessor
error return codes, handling 169
SQL statements
standard
statement numbers, determining from offset 221
statements
storage
STREAM attribute
stream I/O
creating a data set 257 essential information 257
STREAM I/O
stream-oriented data transmission accessing a data set with stream I/O
essential information 260 example 260
creating a data set with stream
defining files using stream I/O 256
ENVIRONMENT options for stream-oriented data transmission 257
using SYSIN and SYSPRINT files 265
structure expression restrictions 5
structure of global control blocks
writing the initialization procedure 373 writing the message filtering procedure 373
writing the termination procedure 375
SYSIN files
redirecting standard input 254
SYSPRINT files
redirecting standard output 254
system
standard action for conditions 220
SYSTEM
linkage, calling conventions 403
Index
523
T
terminal
example of an interactive program 268
termination procedure
compiler user exit 375 example of procedure-specific control block 375
syntax
testing programs
code inspection 211 data testing 211
text file
TITLE option
opening and closing a file 250
specifying the length of records 232
using
using files not associated with data sets 250
user exit
(continued)
customizing
(continued)
writing your own compiler exit 372
using
arrays as host variable, SQL preprocessor 161 using host variables, SQL preprocessor 161
Using Millennium Language Extensions
V
U
U-format record 233 undefined-length record format 233
UNDEFINEDFILE condition
raising when opening a file 248 using files not associated with data sets 248
unexpected
uninitialized entry variables 223
UPPERINC compile-time suboption 49
user defined functions, SQL preprocessor 168
user exit
customizing
structure of global control blocks 372
524
PL/I for Windows Programming Guide variables
environment variables for compile time 21
varying-length records
VSAM
W
WINDOW compile-time option 140
WINDOW compiler option 140, 482
workstation
workstation VSAM (virtual storage access method) data sets
dummy data set 291 file attribute 291
workstation VSAM data sets
adapting programs
using CONSECUTIVE files 293 using INDEXED files 293
using REGIONAL(1) files 294 using VSAM files 294
defining files
adapting existing programs 293
specifying options of the PL/I
keyed
base file 288 prime index file 288 sequential 288 types and advantages 288
workstation VSAM direct data sets
using a DIRECT file to access 309 using a SEQUENTIAL file to access 309
workstation VSAM keyed data sets
using a DIRECT file to access 302 using a SEQUENTIAL file to access 302
workstation VSAM sequential data sets
accessing from a SEQUENTIAL file 296 defining and loading 296
using a SEQUENTIAL file to access 296
WRITE statement, attributes and options 251
X
XREF compile-time option
Pakua
Kiungo cha umma kime sasishwa
Kiungo cha umma kwa mazungumzo yako kimesasishwa. You may view and manage your chat links after registration here.
Kiungo cha umma cha hati
Tangazo
