Kednos PL/I for OpenVMS Systems
User Manual
AREA_INACTIVE, Attempt to unlock an area failed.
Informational: The PL/I run-time library detected an
error while attempting to unlock the interlock bit on an area after
performing an operation on the area. This error can be caused by
assigning to the target area while another operation is active, since
area assignment cannot be fully interlocked.
User Action: Rewrite the application to avoid
assignment to an area while another operation is in progress.
AREA_SIZE, Impossible to allocate variable in area.
Informational: An allocation was attempted in an area
that could not be performed because the size requested was too large to
be allocated from the area, even if the area was empty.
User Action: Correct the situation that caused the
problem to occur.
AUTOINIT, Error in automatic initialization.
Fatal: An automatic variable declared with the INITIAL
attribute cannot be initialized. This error can be caused by a negative
repetition factor in an initial list, or when too few or too many
values are specified in the initialization of an array. PL/I
also does not allow automatic initialization of automatic unconnected
aggregates.
User Action: Correct the initial list.
BADATTR, File attributes conflict with request.
Informational: An error occurred in the execution of
the PL/I compiler or a run-time module.
User Action: Gather as much information as possible
about the circumstances under which the error occurred, and submit an
SPR.
BADRTL, Invalid file control block or uninitialized FILE
VARIABLE.
Informational: A PL/I program was compiled with a
field-test version of the PL/I compilers and linked with a
later version of the run-time library.
User Action: Determine what the correct run-time
library is for your version of the compiler (ask your system manager or
operator, if necessary). Recompile the program with the correct
run-time library.
BASECTLINIT, Error in BASED or CONTROLLED initialization.
Fatal: A BASED or CONTROLLED variable declared with
the INITIAL attribute cannot be initialized. This error can be caused
by a negative repetition factor in an initial list, or when too few or
too many values are specified in the initialization of an array.
PL/I also does not allow automatic initialization of BASED or
CONTROLLED unconnected aggregates.
User Action: Correct the initial list.
BIFSTAPOS, Starting position for a string built-in function is out
of range.
Informational: The third operand in a reference to an
INDEX, SEARCH, or VERIFY built-in function is beyond the range of the
string. This condition is always signaled when strings are being
processed by the PL/I run-time library, but it is raised for in-line
code only if the /CHECK qualifier was specified for the procedure
containing the reference.
User Action: Examine the program to determine the
proper value for the third parameter, and correct the program.
CNVERR, Conversion error.
Informational: An input or output value could not be
converted as specified by the default conversion rules (for example, in
list-directed stream I/O) or as specified by the corresponding format
item (for edit-directed stream I/O).
User Action: Examine the program logic and correct it
if possible. If edit-directed stream I/O is being performed, check to
ensure that the input or output value is matched to the correct format
item.
CONAPPSUP, APPEND and SUPERSEDE conflict.
Informational: These ENVIRONMENT options conflict and
must not be both specified for the same file.
User Action: Determine whether you want to append new
records to the existing file or to supersede it and write a new file.
Correct the source program so that one of these options is not
specified in the DECLARE or OPEN statement for the file.
CONATTR, Conflicting attributes specified while opening file.
Informational: A file was implicitly opened with an
attribute that conflicts with an atttribute specified in the file's
declaration. This error occurs when a file is declared with any of the
following: the DIRECT and SEQUENTIAL attributes, the RECORD and STREAM
attributes, or more than one of the attributes INPUT, OUTPUT, and
UPDATE.
User Action: Determine the correct set of attributes
for the file, and correct the file's declaration.
CONBLOKIO, BLOCK_IO conflicts with other attributes or options.
Informational: The ENVIRONMENT option list for a file
contains the BLOCK_IO option and one or more of the options that
conflict with BLOCK_IO.
User Action: Consult the description of the BLOCK_IO
option to determine the options that conflict, and examine the file's
declaration and OPEN statement. Decide whether the file is to be opened
for BLOCK_IO, and correct the program.
CONDITION, PL/I CONDITION(entity) condition.
Informational: A user-defined condition was signaled
with the SIGNAL CONDITION(user-cond) statement.
User Action: Do nothing, or add an ON-unit to handle
the condition.
CONENVOPT, DECLARED option conflicts with OPEN option.
Informational: The value of an option specified in the
ENVIRONMENT option list in the declaration of a file conflicts with the
value specified on the OPEN statement for the file.
User Action: Determine which value is the correct
value for the option, and correct either the file's declaration or the
OPEN statement.
CONFIXLEN, FIXED_LENGTH_RECORDS conflicts with other attributes or
options.
Informational: The file's attribute list contains the
FIXED_LENGTH_RECORDS option and an option that conflicts with it.
User Action: Consult the option descriptions to
determine the options in conflict, and correct the program.
CONPRINTCR, CARRIAGE_RETURN_FORMAT conflicts with PRINT
attribute.
Informational: A PL/I file with the PRINT attribute
has variable records with fixed-length control; the carriage control
information is provided by PL/I. The CARRIAGE_RETURN_FORMAT option of
ENVIRONMENT cannot be specified for it.
User Action: Determine whether the file is to be a
PL/I PRINT file or a file with VMS carriage return format and correct
the file's attribute list.
CONPRTFRM, PRINTER_FORMAT conflicts with other attributes or
options.
Informational: The ENVIRONMENT option PRINTER_FORMAT
conflicts with the CARRIAGE_RETURN_FORMAT option and with the PRINT and
STREAM file description attributes.
User Action: Correct the file's attribute list.
CONVERSION, PL/I CONVERSION condition.
Fatal: An invalid character was detected during the
conversion of character data to another data type. (For example, the
colon in '12:4' would cause conversion to be raised if this string was
being converted to a FIXED value.)
User Action: Correct the input data or add an ON-unit
to handle the CONVERSION condition. Note that the ONSOURCE and ONCHAR
built-in functions can be used to determine the source of the error,
and that the corresponding pseudovariables can be used to correct the
source string.
CONVFILE, On file entity.
Informational: This displays the name of the file
constant for which the conversion error occurred.
User Action: None.
CREINDEX, Attempting to create an indexed file. Use RMS Define.
Informational: A file was opened with the OUTPUT
attribute and with the ENVIRONMENT option INDEXED. You cannot create an
indexed sequential file in a PL/I program. Indexed files can be opened
only for UPDATE or INPUT.
User Action: Use the RMS utility program FDL to create
the file. Correct the program to open the file with the UPDATE
attribute and write records to it.
CVTPICERR, Error in picture conversion.
Informational: A value could not be edited as
specified by the corresponding picture.
User Action: If the value is negative, be sure that
the picture includes one of the sign characters.
ENDFILE, PL/I ENDFILE condition on file entity.
Fatal: This message is displayed when a READ or GET
statement attempts to access data that is beyond the end of the given
file. The message is displayed only when no user-specified ON-unit
exists to handle the end-of-file condition for the given file.
User Action: Provide an ON-unit for the ENDFILE
condition for the input file.
ENDPAGE, PL/I ENDPAGE condition on file entity.
Warning: This message is displayed when a PUT
statement causes the current line number to exceed the page size
specified for a print file. The message is displayed only if there is
no ON-unit within the file to handle the ENDPAGE condition for the
given file.
User Action: If your program is displaying lines on
the terminal, you may want to include this statement:
This null ON-unit causes PL/I to ignore the ENDPAGE condition when many
lines are being written to the terminal.
For other types of print files, you may want to take special action for
the ENDPAGE condition and code an ON-unit to perform the action.
ENDSTRING, End of string encountered during GET STRING or PUT
STRING.
Informational: A GET STRING statement attempted to
read past the end of the source string variable, or a PUT STRING
statement attempted to write past the end of the target string
variable. This error occurs most frequently when a LIST option is
specified on a GET STRING statement and the target string does not have
either a trailing blank or a comma.
User Action: Verify the length of the target or source
string variable, the data types specified in the GET or PUT list, and
correct the program.
ENVPARM, PL/I compiler/run-time error. Please submit an SPR.
Informational: An error occurred in the execution of
the PL/I compiler or a run-time module.
User Action: Gather as much information as possible
about the circumstances under which the error occurred, and submit an
SPR.
ERROR, PL/I ERROR condition.
Fatal: This message is displayed whenever the ERROR
condition is signaled and not handled within the procedure.
User Action: This message is usually followed by
additional messages that indicate the specific error that occurred.
Examine these messages to determine the corrective action required.
FILEIDENT, PL/I compiler/run-time error. Please submit an SPR.
Informational: An error occurred in the execution of
the PL/I compiler or a run-time module.
User Action: Gather as much information as possible
about the circumstances under which the error occurred, and submit an
SPR.
FILENAME, File name: entity.
Informational: This message specifies the VMS file
specification of the file to which I/O was attempted.
User Action: Examine this informational message to
determine the full specification of the VMS file on which the I/O that
failed was attempted. From this name, you can verify whether the file
was correctly specified in the TITLE option, whether the correct
logical name assignments exist, whether the correct defaults are being
applied, and so on.
FINISH, PL/I Program FINISH condition.
Success: This message is displayed when the FINISH
condition is signaled and the program has no ON-unit for the FINISH
condition.
User Action: In many cases, this message is displayed
when you have interrupted a program with Ctrl/c or Ctrl/y and executed
another program or a DCL command. In these cases, no action is
required. Otherwise, you may want to write an ON-unit to respond
specifically to the FINISH condition in a program. For a description of
image exit, and the circumstances under which PL/I signals the FINISH
condition, see Chapter 10.
FIXOVF, PL/I FIXEDOVERFLOW condition.
Fatal: This message is displayed when the
FIXEDOVERFLOW condition occurs or is signaled and no ON-unit exists for
FIXEDOVERFLOW.
User Action: Determine the variable whose value
overflowed and give it a larger precision, or verify that the program
logic is correct and is not trying to assign a value larger than it
should to the variable. If the condition is expected, code an ON-unit
in your program that handles this condition.
FORMATOVFL, Too many iteration factors or remote formats.
Informational: A format list is too complex to be
interpreted.
User Action: Simplify the stream I/O statement.
FXCSIZ, FIXED_CONTROL_SIZE incorrect.
Informational: The size of the variable in the
FIXED_CONTROL_FROM or FIXED_CONTROL_TO option does not match the size
of the file's fixed-control area.
User Action: Determine the correct size of the
fixed-control area, and correct the source program or verify that the
correct file is being accessed.
INCRETURN, RETURN statement is incompatible with ENTRY.
Fatal: A procedure does not have the RETURNS
attribute, but an entry within that procedure specifies the RETURNS
option and attempts to execute a RETURN statement.
User Action: Correct the source program by specifying
the RETURNS attribute on the PROCEDURE statement or by removing it from
the ENTRY statement.
INTERNAL, PL/I compiler/run-time error. Please submit an SPR.
Fatal: An error occurred in the execution of the PL/I
compiler or a run-time module.
User Action: Gather as much information as possible
about the circumstances under which the error occurred, and submit an
SPR.
INVBKTSIZ, Invalid BUCKET_SIZE specified.
Informational: The value specified in the BUCKET_SIZE
ENVIRONMENT option is not in the range 0 through 32. The largest number
of blocks allowed in a bucket by VAX RMS is 32.
User Action: Select a bucket size that is in the
correct range, and correct the source program.
INVBLKSIZ, Invalid BLOCK_SIZE specified.
Informational: The value specified in the BLOCK_SIZE
ENVIRONMENT option is not in the range 20 through 65532 or is not 0.
User Action: Select a block size that is in the valid
range, and correct the program.
INVDATYP, Invalid data type for record I/O.
Informational: The data type of a variable in a record
I/O statement is not a computational data type; or the data type is
computational but is an unconnected array or structure, an unaligned
bit string, or an aggregate of unaligned bit strings.
User Action: Verify that the correct variable name was
specified in the I/O statement. If the variable is an aggregate, you
may have to redimension or restructure it so that the required array is
connected.
INVDFNAM, Invalid DEFAULT_FILE_NAME.
Informational: The expression value specified in the
DEFAULT_FILE_NAME ENVIRONMENT option is not a valid character-string
expression, or it is longer than 128 characters.
User Action: Verify that the expression is correctly
specified, if a variable reference is specified, that the reference is
correct. Correct the source program.
INVEXTSIZ, Invalid EXTENSION_SIZE specified.
Informational: The value specified in the
EXTENSION_SIZE option of ENVIRONMENT is not in the range 0 through
65535 or is not a valid integer expression.
User Action: Correct the expression.
INVFMTPARM, Invalid format parameter specified.
Informational: A value specified for a format item was
not a positive integer, or the value was not in the valid range for the
given format item. For example, this error occurs if a negative number
is specified for the A or B format item, or if a value greater than 31
is specified for the F format item.
User Action: Correct the value specified for the
format item in the source program.
INVFORGKEY, Invalid file organization for KEYED access.
Informational: The KEYED attribute was specified for a
file that cannot be accessed by key, for example, a magnetic tape file.
User Action: Verify that the correct file is being
opened by checking the TITLE and DEFAULT_FILE_NAME options, if any,
logical name assignments, and file specification defaults. If the file
is the expected file, correct the attribute list so that it does not
specify the KEYED attribute.
INVFORMAT, PL/I compiler/run-time error. Please submit an SPR.
Informational: An error occurred in the execution of
the PL/I compiler or a run-time module.
User Action: Gather as much information as possible
about the circumstances under which the error occurred and submit an
SPR.
INVFXCSIZ, Invalid FIXED_CONTROL_SIZE specified.
Informational: The value specified in the
FIXED_CONTROL_SIZE ENVIRONMENT option is not in the range 0 through 255.
User Action: Verify that the expression in the
FIXED_CONTROL_SIZE option is correctly specified or that it refers to
the correct variable. Or choose a fixed-control size that is within the
valid range. Correct the program.
INVINDNUM, Invalid INDEX_NUMBER specified.
Informational: The value specified for the
INDEX_NUMBER option does not have a corresponding index in the indexed
sequential file.
User Action: Verify that the expression specified in
the option is correct or that it refers to the correct variable. Or
specify an index number that is in the proper range, ensuring that the
indexed sequential file was defined with the correct number of index
keys. Correct the program.
INVMAXREC, Invalid MAXIMUM_RECORD_SIZE specified.
Informational: The value specified for the
MAXIMUM_RECORD_SIZE option of ENVIRONMENT is not in the range 0 through
32767.
User Action: Correct the value so that it is not
larger than 32767.
INVMLTBLK, Invalid MULTIBLOCK_COUNT specified.
Informational: The value specified in the
MULTIBLOCK_COUNT count of the ENVIRONMENT option is not in the range 0
through 127, or is not a valid integer expression.
User Action: Verify that the expression in the
MULTIBLOCK_COUNT option is correct, or that the correct variable
reference is specified. Correct the program.
INVMLTBUF, Invalid MULTIBUFFER_COUNT specified.
Informational: The value specified in the
MULTIBUFFER_COUNT count of the ENVIRONMENT option is not in the range
-128 through 127, or is not a valid integer expression.
User Action: Verify that the expression in the
MULTIBUFFER_COUNT option is correct, or that the correct variable
reference is specified. Correct the program.
INVNUMOPT, PL/I compiler/run-time error. Please submit an SPR.
Informational: An error occurred in the execution of
the PL/I compiler or a run-time module.
User Action: Gather as much information as possible
about the circumstances under which the error occurred and submit an
SPR.
INVOWNGRP, Invalid OWNER_GROUP specified.
Informational: The value specified for the OWNER_GROUP
ENVIRONMENT option is not in the range 0 through 16383, or is not a
valid integer expression.
User Action: Correct the program.
INVOWNMEM, Invalid OWNER_MEMBER specified.
Informational: The value specified for the
OWNER_MEMBER ENVIRONMENT option is not in the range 0 through 65535, or
is not a valid integer expression.
User Action: Correct the program and recompile.
INVPROT, Invalid protection string specified.
Informational: The value specified for one of the
ENVIRONMENT options GROUP_PROTECTION, OWNER_PROTECTION,
SYSTEM_PROTECTION, or WORLD_PROTECTION is not a valid string
expression; the string contains more than four characters; or the
string contains characters other than the characters R, W, E, or D, or
their lowercase equivalents.
User Action: Correct the value specified in the
option, and recompile the program.
INVRADIX, An invalid radix was specified.
Fatal: The radix specified for the ENCODE or DECODE
built-in function was not a value between 2 and 16.
User Action: Change the radix to a value between 2 and
16.
INVRTVPTR, Invalid RETRIEVAL_POINTERS specified.
Informational: The value specified for the ENVIRONMENT
option RETRIEVAL_POINTERS is not in the range -1 through 127, or is not
a valid integer expression.
User Action: Verify that the expression specified in
the RETRIEVAL_POINTERS option is a valid integer expression or, if a
variable reference is specified, that it refers to the appropriate
variable. Correct the program.
INVSKIP, Invalid value for SKIP option specified.
Informational: The value specified in a SKIP option is
zero (on an input operation) or is negative (for either an input or an
output operation).
User Action: Determine the value of the SKIP option;
if a variable reference is specified, verify that the variable contains
the correct value.
INVSTRFMT, Invalid format item for STRING I/O.
Informational: One of the format items COL, SKIP,
LINE, PAGE, or TAB was specified in a GET STRING or PUT STRING
statement. These format items are not valid for these statements.
User Action: Correct the format list for the statement
that caused the error.
INVSTRING, Invalid character encountered in string.
Fatal: Invalid characters were specified for the
string argument of the DECODE built-in function.
User Action: Remove the invalid characters.
INVTIME, Invalid timeout value specified.
Fatal: An invalid timeout value has been specified.
The number of seconds to wait must be less than 256.
User Action: Correct the timeout value.
INV_KEY, Invalid KEY data type.
Informational: The data type of a key in an indexed
sequential file is not a data type known to PL/I.
User Action: Verify that the file has not been
corrupted. Revert to an earlier version of the file, if possible.
IOERROR, I/O error on file entity.
Informational: This informational message indicates
that an error occurred during an I/O operation.
User Action: Examine the accompanying messages to
determine the error.
KEY, PL/I KEY condition on file entity.
Fatal: This message is followed by one or more
messages that indicate the specific error that occurred while
processing the key on the given file.
User Action: Determine the specific error that
occurred by examining the accompanying RMS message. Verify in your
program that the correct key value was specified in the I/O statement,
that the data type of the key value can be converted to the data type
of the given key, and so on. Also determine whether the file to which
the I/O was attempted is the correct file. If appropriate, write an
ON-unit to handle the KEY condition.