Index

Symbols

$signaldef, Accessing the Signal Values
%PROCEDURE statement, Preprocessor Procedures
%RETURNS statement, Preprocessor Procedures

A

Access modes, Access Modes for Record I/O

keyed, Direct Access
sequential, Sequential Access
using record identification, Access by Record Identification

Activation records of ON-units, Search Path for ON-Units

ADDR built-in function, Using Pointer Values for Arguments Passed by Reference

ANY attribute, Values Returned by PL/I Built-In Functions for Error Handling, Using the ANY Attribute, Passing Parameters by Value

using with VALUE, Dummy Arguments for Arguments Passed by Value

ANY OPTIONAL, OPTIONAL Attribute

ANYCONDITION ON-unit

affect of nonlocal GOTO, Multiple Conditions
calling during unwind, Multiple Conditions
located in search for ON-units, Default Handling for Main Procedures, Default Handling for Non-Main Procedures
STOP statement in, Multiple Conditions

APPEND ENVIRONMENT option, APPEND Option

example, Appending Records to an Existing File

Archive libraries, Run-Time Libraries

AREA condition, ONCODE Built-In Function

Arguments

optional, OPTIONAL Attribute

passing

by reference, Passing Parameters by Reference
by value, Passing Parameters by Value

specifying pointer values, Using Pointer Values for Arguments Passed by Reference

truncating lists of, TRUNCATE Attribute

Arrays

passing as arguments, Passing Parameters by Reference

by reference, Passing Parameters by Reference
to FORTRAN, Passing Arrays to a FORTRAN Routine by Reference

Ascending sort, start,length,format,order

Assembly language, Compilation with pl1

Attributes for file access, Access Modes for Record I/O

B

Binary, Compilation with pl1

Bit strings

passing by reference, Passing Parameters by Reference
passing by value, Passing Parameters by Value

Boolean expressions

in ENVIRONMENT options, Boolean Values
in I/O statement options, Option Format

Buffers, file, FLUSH Built-In Subroutine (DEC Dialect Only)

Built-in functions

ADDR, Using Pointer Values for Arguments Passed by Reference
condition-handling, Condition-Handling Built-In Functions
ONCODE, ONCODE Built-In Function
ONFILE, ONFILE Built-In Function
ONKEY, ONKEY Built-In Function
preprocessor, Preprocessor Built-In Functions

Built-in subroutines

file-handling, File-Handling Built-In Subroutines
FLUSH, FLUSH Built-In Subroutine (DEC Dialect Only)
RESIGNAL, Summary of ENVIRONMENT Options, RESIGNAL Built-In Subroutine, Resignaling the Condition
REWIND, REWIND Built-In Subroutine (DEC Dialect Only)

C

C, Compiling Multi-Language Programs

Call frame

for ON-unit, Search Path for ON-Units
removing from call stack, Executing a Nonlocal GOTO

Call stack

execution of ON-unit, Search Path for ON-Units

searching for ON-units, Reading a Relative File Sequentially, Search Path for ON-Units, Default Handling for Non-Main Procedures

during unwind, Executing a Nonlocal GOTO
effect of RESIGNAL, Fixed-Length Records, Resignaling the Condition

unwind, Executing a Nonlocal GOTO

CALL statement

external routines, Calling the External Routine
FORTRAN example, Passing Arrays to a FORTRAN Routine by Reference
non-PL/I routines, Using PL/I in the Common Language Environment

CANCEL_CONTROL_O option, Summary of Input/Output Statement Options

Character strings

as arguments to ENVIRONMENT options, Expressions

passing as arguments, Passing Parameters by Reference

reading and writing

fixed-length, Fixed-Length Records
varying-length, Variable-Length Records

chmod command, Defining File Protection

Cleanup procedures, ON-Unit Examples

CLOSE statement, File Control

specifying ENVIRONMENT options, Specifying and Using Environment Options

Compiler

causes of warnings, Compiler Error Messages
components of, The pl1 Command
diagnostic message format, Compiler Error Messages
diagnostic messages, Compiler Messages
driver options, Driver Options
drivers for other languages, Compiling Multi-Language Programs
error severity, Compiler Error Messages
function of, Creating Source Files
processing phases, Compilation with pl1
syntax error detection, Compiler Error Messages

CONDITION condition, ONCODE Built-In Function

Condition handlers, Relationship of UNIX Signals to PL/I ON-Units

compared to ON-units, Relationship of UNIX Signals to PL/I ON-Units
courses of action, ON-Unit Actions
default, Default Handling for Main Procedures
defaults in routines, Default Handling for Non-Main Procedures
effects of using, Handling the Condition
multiple active, Multiple Conditions
resignaling a condition, Summary of ENVIRONMENT Options, RESIGNAL Built-In Subroutine, Resignaling the Condition
search order, Reading a Relative File Sequentially, Search Path for ON-Units
signal(3), Relationship of UNIX Signals to PL/I ON-Units
unwinding the call stack, Executing a Nonlocal GOTO
using built-in functions, Condition-Handling Built-In Functions
using STOP statement in, Stopping the Program
VAXCONDITION, VAXCONDITION Condition

Condition Handling Standard support, The UNIX Procedure Calling and Condition Handling Standard

Condition values

file errors, Error Handling
user-defined, VAXCONDITION Condition

CONSECUTIVE ENVIRONMENT option, CONSECUTIVE Option

Constants, file, File Control

D

Default condition handling

main procedure, Default Handling for Main Procedures
non-main procedure, Default Handling for Non-Main Procedures

DEFAULT_FILE_NAME ENVIRONMENT option, DEFAULT_FILE_NAME Option

DELETE ENVIRONMENT option, DELETE Option

Descending sort, start,length,format,order

DIRECT file access, Access Modes for Record I/O

Driver options, Driver Options

Dummy arguments

for by-value arguments, Dummy Arguments for Arguments Passed by Value
passing by reference, Dummy Arguments for Arguments Passed by Reference

Duplicate keys, errors in, Writing an Error Handler

E

ENDFILE condition, Error Handling, ONCODE Built-In Function, ONKEY Built-In Function

ENDPAGE condition, Error Handling, ONCODE Built-In Function

action by default handler, Default Handling for Main Procedures

ENTRY attribute, declaring non-PL/I routines, Passing Parameters by Value

Entry name, as procedure argument, Passing Parameters by Value

ENVIRONMENT options, Options of the ENVIRONMENT Attribute

APPEND, APPEND Option
CONSECUTIVE, CONSECUTIVE Option
DEFAULT_FILE_NAME, DEFAULT_FILE_NAME Option
DELETE, DELETE Option
F, FB, FS, and FSB, Valid Dialects: ibm, Valid Dialects: ibm
FIXED_LENGTH_RECORDS, BLKSIZE Option, F, FB, FS, or FSB Option, FIXED_LENGTH_RECORDS Option, V, VB, VS, or VSB Option
GROUP_PROTECTION, GROUP_PROTECTION Option, Relationship of UNIX Signals to PL/I ON-Units
MAXIMUM_RECORD_SIZE, MAXIMUM_RECORD_SIZE Option, RECSIZE Option
OWNER_PROTECTION, OWNER_PROTECTION Option
RECORD_ID_ACCESS, Valid Dialects: ansi, dec
SCALARVARYING, Valid Dialects: ansi, dec, ibm
SHARED_READ, Valid Dialects: ansi, dec
specifying, Specifying and Using Environment Options
specifying arguments, Expressions, Boolean Values
summary, Summary of ENVIRONMENT Options, RESIGNAL Built-In Subroutine
SUPERSEDE, Valid Dialects: ansi, dec
TEMPORARY, Valid Dialects: ansi, dec
V, VB, VS, and VSB, Valid Dialects: ibm
WORLD_PROTECTION, WORLD_PROTECTION Option

Environment variables, Using Environment Variables

EQUALS (sort option), OPTION1...,OPTIONn

ERROR condition, ONCODE Built-In Function

action by default handler, Default Handling for Main Procedures

default ON-unit action, Handling the Condition

for file errors, Error Handling

signaled

by default ON-unit, Default Handling for Main Procedures

ERROR ON-unit, ON-Unit Examples

Errors

compiler messages, Compiler Messages

ENVIRONMENT options, Conflicting and Invalid ENVIRONMENT Options, Error Handling

file

default handling, Default Error Handling for the File System
error handler, Writing an Error Handler

handling, Conflicting and Invalid ENVIRONMENT Options, Error Handling

file, Error Handling
of file-related error, ONFILE Built-In Function
ON conditions, Conflicting and Invalid ENVIRONMENT Options, Error Handling

message format in compiler, Compiler Error Messages

relative file, Error Handling

run-time, Run-Time Errors

run-time messages, Run-Time Messages

severity, Compiler Error Messages

syntax, Compiler Error Messages

when passing arguments, Dummy Arguments for Arguments Passed by Reference

Executable binary, Compilation with pl1

Executing a PL/I program, Running a PL/I Program

Exit status

run-time panic, Panic Messages
unhandled condition, Message Format

External procedures as arguments, Passing Parameters by Value

External routines

calling, Calling Routines
non-PL/I, Using PL/I in the Common Language Environment

F

F, FB, FS, and FSB ENVIRONMENT options, Valid Dialects: ibm, Valid Dialects: ibm

FAST_DELETE option, Summary of Input/Output Statement Options

Fatal severity condition handling, Default Handling for Main Procedures

FILE attribute, File Control

File constants, Using the TITLE Option

File specifications

completing, Using the TITLE Option
expanded, Expanding File Specifications
for error, ONFILE Built-In Function
invalid, Using the TITLE Option
TITLE option, Using the TITLE Option

Files, The File System

access modes and PL/I attributes, Access Modes for Record I/O

access privileges, File Protection

accessing, File Control

built-in subroutines for, File-Handling Built-In Subroutines

closing, File Control

creating, Creating a Stream File

declaring, File Control

default version numbers, Expanding File Specifications

error conditions in, Error Handling

handling errors, Writing an Error Handler

keyed, error handler ex., Writing an Error Handler

opening

ENVIRONMENT options, Interpretation of ENVIRONMENT Options for Existing Files
positioning, File Control

organization, File Organizations

ownership, File Protection

prefix for sort files, Specifying a File Prefix

process permanent, Process Standard System File Names

protection, File Protection

specifying, Defining File Protection

reading and writing, Using Relative Files, Updating a Relative File, Rules

record, File Organizations and Input/Output

relative, Relative Files, Error Handling

signaling ONKEY built-in function, ONKEY Built-In Function

stream, Creating a Stream File

FILSZ (sort option), OPTION1...,OPTIONn

FINISH condition

signaled

by default handler, Default Handling for Main Procedures
by STOP statement, Stopping the Program

STOP statement in ON-unit, Multiple Conditions

Fixed-length records, Fixed-Length Records

FIXEDOVERFLOW condition, ONCODE Built-In Function

FIXED_LENGTH_RECORDS ENVIRONMENT option, Fixed-Length Records, BLKSIZE Option, F, FB, FS, or FSB Option, FIXED_LENGTH_RECORDS Option, V, VB, VS, or VSB Option

FLUSH built-in subroutine, FLUSH Built-In Subroutine (DEC Dialect Only)

Formats, record, Record Formats

Fortran, Compiling Multi-Language Programs

FORTRAN routines, passing arrays to, Passing Arrays to a FORTRAN Routine by Reference

Functions, calling, Calling the External Routine

G

GET statement

default file title, Process Standard System File Names
NO_ECHO option, NO_ECHO Option
suppressing display of input, NO_ECHO Option
with PROMPT option, Usage

Global symbols

condition value, ONCODE Built-In Function

ONCODE values, ONCODE Built-In Function

reference in ON-unit

example, Error Handling

referencing in ON-unit, Writing an Error Handler, ONCODE Built-In Function

GOTO statement, nonlocal, Executing a Nonlocal GOTO

GROUP_PROTECTION ENVIRONMENT option, GROUP_PROTECTION Option, Defining File Protection, Relationship of UNIX Signals to PL/I ON-Units

I

I/O

overview of operating system features, The File System
statement options, NO_ECHO Option, RECORD_ID_TO Option

I/O Statement options

format, Option Format

I/O statement options, Summary of Input/Output Statement Options, PROMPT Option

IBM dialect, Error Handling

File environment options, IBM Dialect Fixed Length Environment Options, IBM Dialect Variable Length Environment Options

Include files

input parameter declarations, Accessing Command Line Parameters in PL/I Programs

Indexed files

error messages, Indexed File Messages

Input files, defining, Using the TITLE Option

Input/Output

file specifications, PL/I Files and UNIX File Specifications
record file, File Organizations and Input/Output
stream file, Stream Files
to a file, Using the UNIX File System for I/O

K

KEY condition, Error Handling, ONKEY Built-In Function

sample ON-unit, Writing an Error Handler, Error Handling

KEY option, in relative file, Using Relative Files

KEYED attribute

creating a relative file with, Creating a Relative File
example, Using Relative Files
file access, Access Modes for Record I/O

Keys

file access using, Direct Access
handling errors in, Writing an Error Handler, Error Handling, Default Handling for Non-Main Procedures

L

Labels

preprocessor, Preprocessor Statements and Procedures

Length of variable length records, Variable-Length Records

Link edit, Compilation with pl1

Linking objects, Linking Objects using the pl1 Command

specifying run-time library, Library Search Path

M

Main procedure condition handling, Default Handling for Main Procedures

MAXIMUM_RECORD_SIZE ENVIRONMENT option, Fixed-Length Records, Variable-Length Records, Maximum Record Size, MAXIMUM_RECORD_SIZE Option, RECSIZE Option

Message level (for sorting), Specifying Message Level

Messages

compiler, Compiler Messages
run-time, Run-Time Messages

Multiple active conditions, Multiple Conditions

N

NAME condition, Error Handling

NOEQUALS (sort option), OPTION1...,OPTIONn

Non-PL/I routines, Parameter-Passing Mechanisms

calling, Using PL/I in the Common Language Environment, Calling Routines

Nonlocal GOTO, Executing a Nonlocal GOTO

NO_ECHO option, NO_ECHO Option

Null statements, in ON-units, ON-Unit Examples

O

Object file, Compilation with pl1

Object libraries, Run-Time Libraries

ON conditions, Error Handling, Conflicting and Invalid ENVIRONMENT Options, Error Handling

ON-units

call frame created for, Search Path for ON-Units

compared to condition handlers, Relationship of UNIX Signals to PL/I ON-Units

courses of action, ON-Unit Actions

examples of, ON-Unit Examples

for KEY condition

in indexed file, Writing an Error Handler
in relative file, Error Handling

referencing global symbols, ONCODE Built-In Function

examples, Writing an Error Handler, Error Handling

scope of, Scope of ON-Units

searching of call stack, Reading a Relative File Sequentially, Search Path for ON-Units

ONCODE built-in function, Values Returned by PL/I Built-In Functions for Error Handling, ONCODE Built-In Function, Using the ANY Attribute

return value global symbol names, ONCODE Built-In Function
STATUS variable, ON-Unit Examples
testing, Resignaling the Condition
values in KEY ON-unit, Writing an Error Handler, Error Handling

ONFILE built-in function, Values Returned by PL/I Built-In Functions for Error Handling, ONFILE Built-In Function

ONKEY built-in function, Values Returned by PL/I Built-In Functions for Error Handling, ONKEY Built-In Function

ONCODE values, Writing an Error Handler, Error Handling

OPEN statement, File Control

specifying TITLE option, Using the TITLE Option

OPTIONAL attribute, OPTIONAL Attribute

Options

ENVIRONMENT, Options of the ENVIRONMENT Attribute

summary, Summary of ENVIRONMENT Options, RESIGNAL Built-In Subroutine

OPTIONS MAIN default condition handling, Default Handling for Main Procedures

OPTIONS option, Option Format

OPTIONS(VARIABLE) option, OPTIONS(VARIABLE) Option

OUTPUT attribute

creating a new file, Creating a Stream File
example, Using Relative Files

Output, record, File Organizations and Input/Output

OVERFLOW condition, ONCODE Built-In Function

OWNER_PROTECTION ENVIRONMENT option, OWNER_PROTECTION Option, Defining File Protection

P

Parameters

attributes, Special Parameter Attributes
passing to non-PL/I routines, Parameter-Passing Mechanisms
VALUE attribute, Passing Parameters by Value

Pascal, Compiling Multi-Language Programs

pl1 command, The pl1 Command

error messages, Compiler Error Messages
linking objects, Linking Objects using the pl1 Command

pl1std.in, Accessing Command Line Parameters in PL/I Programs

PLIRETC built-in subroutine, Using the PLIRETC Built-In Subroutine

PLISRTA, Determining Which Entry Point to Use

example, Specifying Storage, Specifying a File Prefix, Programming Examples

PLISRTB, Determining Which Entry Point to Use

example, Specifying Message Level

PLISRTC, Determining Which Entry Point to Use

PLISRTD, Determining Which Entry Point to Use

example, Using the Return Code, Programming Examples

Pointers, passing as arguments, Using Pointer Values for Arguments Passed by Reference

Preprocessor, PL/I Preprocessor

built-in functions, Preprocessor Built-In Functions
procedures, Preprocessor Procedures, Preprocessor Statements and Procedures
statements, Preprocessor Statements and Procedures
variables, Preprocessor Compilation Control

Procedure Calling Standard support, The UNIX Procedure Calling and Condition Handling Standard

Procedures

calling, Calling the External Routine
passing as arguments, Passing Parameters by Value
preprocessor, Preprocessor Procedures

Process permanent files, Process Standard System File Names

Program, executable, Compilation with pl1

Prompt

with GET statement, PROMPT Option

PROMPT option, PROMPT Option

Protection files, File Protection, Defining File Protection

PURGE_TYPE_AHEAD option, PURGE_TYPE_AHEAD Option

PUT statement, Process Standard System File Names

R

Random file access, Direct Access

Reading files, Direct Access, Using Relative Files, Updating a Relative File

RECORD condition, Error Handling

Record Management Services (RMS), condition values, Writing an Error Handler

Records

cell number, Relative Files

format, Record Formats

fixed-length, Fixed-Length Records, Resignaling the Condition
variable-length, Variable-Length Records

identification, accessing records by, Access by Record Identification

read into varying strings, Variable-Length Records

record files, File Organizations and Input/Output

record I/O, File Organizations and Input/Output

specifying size, Fixed-Length Records, Maximum Record Size

RECORD_ID option, Access by Record Identification, RECORD_ID Option

RECORD_ID_ACCESS ENVIRONMENT option, Access by Record Identification, Valid Dialects: ansi, dec

RECORD_ID_TO option, Access by Record Identification, RECORD_ID_TO Option

Reference, passing by, Passing Parameters by Reference

ANY attribute, Values Returned by PL/I Built-In Functions for Error Handling, Using the ANY Attribute

Relative files, Relative Files, Maximum Record Size, Using Relative Files, Updating a Relative File

creating, Creating a Relative File, Using Relative Files
examples, Relative Files
handling errors in, Error Handling
keys of, Direct Access
ONKEY built-in function, ONKEY Built-In Function
populating, Using Relative Files
updating, Updating a Relative File

RESIGNAL built-in subroutine, Summary of ENVIRONMENT Options, RESIGNAL Built-In Subroutine, Resignaling the Condition

REVERT statement, Scope of ON-Units

REWIND built-in subroutine, REWIND Built-In Subroutine (DEC Dialect Only)

Routines

non-PL/I, Parameter-Passing Mechanisms

Run-time

errors, Run-Time Errors

libraries, Run-Time Libraries

search path, Library Search Path
search path with -L, Library Search Path

messages, Run-Time Messages

Running a PL/I program, Running a PL/I Program

S

SCALARVARYING ENVIRONMENT option, Valid Dialects: ansi, dec, ibm

Scope

in sort routines, Input and Output Routines

Search order for ON-units, Reading a Relative File Sequentially, Search Path for ON-Units, Default Handling for Main Procedures, Default Handling for Non-Main Procedures

Sequential file access, Access Modes for Record I/O

SET PROTECTION command, Defining File Protection

Severity

of compiler errors, Compiler Error Messages
of conditions, ONCODE Built-In Function
of resignaled condition, Default Handling for Main Procedures

SHARED_READ ENVIRONMENT option, Valid Dialects: ansi, dec

Signal condition

user-defined values, VAXCONDITION Condition
values, ONCODE Built-In Function

Signal values, Accessing the Signal Values

signal(3), GROUP_PROTECTION Option, Relationship of UNIX Signals to PL/I ON-Units

SKIPREC (sort option), OPTION1...,OPTIONn

sort command, Using Sort Subroutines (IBM Only)

Sorting

calling the entry points, Determining Which Entry Point to Use
compatibility, How the Sort Program Interface Works
data format, start,length,format,order
examples of calls, Programming Examples
file prefix, Specifying a File Prefix
file-prefix, General Format of the Sort Interface Call
format of call, General Format of the Sort Interface Call
input routines, Input and Output Routines
input-routine, General Format of the Sort Interface Call
maximum-storage, General Format of the Sort Interface Call
message-level, General Format of the Sort Interface Call, Specifying Message Level
output routines, Input and Output Routines
output-routine, General Format of the Sort Interface Call
PLIRETC built-in subroutine, Using the PLIRETC Built-In Subroutine
record length, LENGTH
record type, RECTYPE
record-specification, General Format of the Sort Interface Call
return-code, General Format of the Sort Interface Call, Using the Return Code
scope of variables, Input and Output Routines
sort command, Using Sort Subroutines (IBM Only)
sort field length, start,length,format,order
sort order, start,length,format,order
sort-specification, General Format of the Sort Interface Call, Specifying the Sort Fields
starting point, start,length,format,order
storage, Specifying Storage

Source file

compiler-generated line numbers, Compiler Error Messages
creating, Creating Source Files

Standard input, Process Standard System File Names

Standard output, Process Standard System File Names

stdin, Process Standard System File Names

stdout, Process Standard System File Names

STOP statement in ON-unit, Stopping the Program

Storage (for sorting), Specifying Storage

STORAGE condition, ONCODE Built-In Function

Stream files, Creating a Stream File

appending records to, Creating a Stream File
appending to, Superseding an Existing File
creating, Creating a Stream File
input/output processing, Stream Files

STRINGRANGE condition, ONCODE Built-In Function

Structures

using as file layout, Using Relative Files

Subroutines for file-handling, File-Handling Built-In Subroutines

SUPERSEDE ENVIRONMENT option, Superseding an Existing File, Valid Dialects: ansi, dec

SYSIN, ON-Unit Examples

defaults for, Process Standard System File Names

SYSPRINT

defaults for, Process Standard System File Names

System routines, Using PL/I in the Common Language Environment

T

TEMPORARY ENVIRONMENT option, Valid Dialects: ansi, dec

Terminal input

displaying prompting message, PROMPT Option
suppressing display, NO_ECHO Option

TITLE option, Using the TITLE Option, Using Environment Variables

Traceback, run-time file errors, Default Error Handling for the File System

TRANSMIT condition, Error Handling

TRUNCATE attribute, TRUNCATE Attribute

Type-ahead buffer, purging, PURGE_TYPE_AHEAD Option

U

ucode, Compilation with pl1

UNDEFINEDFILE condition, Using the TITLE Option, Error Handling, ONCODE Built-In Function, ONKEY Built-In Function

ENVIRONMENT option conflicts, Conflicting and Invalid ENVIRONMENT Options
invalid file specifications, Using the TITLE Option

UNDERFLOW condition, ONCODE Built-In Function

Unwind, Executing a Nonlocal GOTO, Multiple Conditions

Updating relative files, Updating a Relative File

User identification code, specifying, File Protection

V

V, VB, VS, and VSB ENVIRONMENT options, Valid Dialects: ibm

VALUE attribute, Passing Parameters by Value

parameter descriptor, Passing Parameters by Value
using with ANY, Dummy Arguments for Arguments Passed by Value

Value, passing by, Passing Parameters by Value

Variable-length records, Variable-Length Records

Variables

environment, Using the TITLE Option

specifying file title with, Environment Variables in TITLE Values

file, File Control, PL/I Files and UNIX File Specifications

file, specifying title with, Using the TITLE Option

preprocessor, Preprocessor Compilation Control

using in signals, Accessing the Signal Values

Varying character strings, Variable-Length Records

VAXCONDITION condition, VAXCONDITION Condition, ONCODE Built-In Function

calling during unwind, Multiple Conditions
located in search for ON-units, Error Handling, Default Handling for Main Procedures, Default Handling for Non-Main Procedures

Version numbers, default, Expanding File Specifications

W

WORLD_PROTECTION ENVIRONMENT option, WORLD_PROTECTION Option, Defining File Protection
Writing files, Using Relative Files, Updating a Relative File

Z

ZERODIVIDE condition, ONCODE Built-In Function