LSCA AR370 Messages

This chapter documents messages generated by the AR370 archive utility on mainframe and cross-platforms. After the text of each message is an explanation of the message and any variables in the message. All messages can occur in any operating environment unless otherwise indicated in the explanation. In some cases, messages from the run-time library that further describe the problem may appear in conjunction with the AR370 diagnostics.

AR370 diagnostic messages have the form 

   LSCAmessage-number severity: message-text
where
message-number
is the message number.
severity
is the severity level of the message (WARNING or ERROR).
message-text
is a description of

Note: The AR370 message prefix (LSCA) is omitted from the message numbers in the following list.

LSCA Messages

Note: MM = Multiple messages.
    002
(MM)		 003 004 005 006 007 008  
010 011
(MM)		 012 013 014
(MM)		 015  

002

WARNING: The continuation of control statements is not supported.

Explanation

OS/390 only: A non-blank character in column 72 of a control statement may indicate an attempt to continue the control statement on to the next card, which is not supported. The next card will be treated as a comment and is not processed. AR370 continues processing.

002

WARNING: unable to find positioning member positioning-name, member member-name appended.

Explanation

An attempt to add a new member or to replace or move an existing member to a position relative (BEFORE or AFTER) to an existing member of the archive failed because the positioning member specified is not currently part of the archive. AR370 continues processing. Some systems may do character translations or change the case of the command line.

Action

Make sure the spelling and case of positioning-name is correct. Use AR370 to display or type the names of the members in the archive.

002

WARNING: unable to find move target member-name.

Explanation

An attempt to move the member member-name in the archive failed because a member by that name is not currently part of the archive. AR370 continues processing. Some systems may do character translations or change the case of the command line.

Action

Make sure the spelling and case of member-name is correct. Use AR370 to display or type the names of the members in the archive.

002

WARNING: unable to find delete target member-name.

Explanation

An attempt to delete the member member-name in the archive failed because a member by that name is not currently part of the archive. Some systems may do character translations or change the case of the command line.

Action

Make sure the spelling and case of member-name is correct. Use AR370 to display or type the names of the members in the archive.

002

WARNING: unable to find extract target member-name.

Explanation

An attempt to extract the member member-name in the archive failed because a member by that name is not currently part of the archive. Some systems may do character translations or change the case of the command line.

Action

Make sure the spelling and case of member-name is correct. Use AR370 to display or type the names of the members in the archive.

002

WARNING: The s command modifier is not supported.

Explanation

The s command modifier to force the regeneration of the archive symbol table is accepted for compatibility, but it has no effect. Processing continues. AR370 by default regenerates the archive symbol table whenever the archive is changed.

002

WARNING: The u command modifier is not supported.

Explanation

The u command modifier, used to prevent replacing a newer archive member with an older input file, was accepted for compatibility, but it has no effect. Processing continues.

002

WARNING: The p command is not supported.

Explanation

The p command modifier, used to print members of the archive, was accepted for compatibility, but it had no effect. Processing continues.

002

WARNING: The f command is not supported.

Explanation

UNIX only: The f command modifier, used to force truncation of file names, was accepted for compatibility, but it had no effect. Processing continues.

003

ERROR: opening file file-name. message-text.

Explanation

An attempt to open the file file-name failed. The message-text is a brief description of the error detected by the run-time library. Under OS/390 this error will occur when the file-name is a DDname, and the DDname is not defined, but any file system problem or failure that might cause an open to fail could also cause this message.

004

ERROR: reading file file-name. message-text.

Explanation

An error occurred when attempting to read from the file or archive named file-name. The message-text is a brief description of the error detected by the run-time library.

This diagnostic may be produced if the archive has been modified by any utility other than AR370, but any file system problem or failure that might cause a read to fail could also cause this message.

Action

Re-run AR370 with the =warning run-time option to provide additional SAS/C Library diagnostics. Check all input files for validity and integrity. In general input files should be fixed length record format with 80 byte records.

005

ERROR: Not enough memory available, AR370 cannot continue.

Explanation

An attempt to allocate memory failed.

Action

Try to increase the amount of memory available to AR370.

006

ERROR: positioning file file-name. message-text.

Explanation

An attempt to move read/write file pointer within an archive named file-name failed. The message-text is a brief description of the error detected by the run-time library.

This diagnostic may be produced if the archive has been modified by any utility other than AR370, but any file system problem or failure that might cause a seek to fail could also be the cause.

Action

Re-run AR370 with the =warning run-time option to provide additional SAS/C Library diagnostics. Check the file for validity and integrity.

007

ERROR: writing file file-name. message-text.

Explanation

An attempt to write one or more items to the output file stream was unsuccessful. Usually this is caused by having insufficient space available for all the output, but any file system problem or failure that might cause a write to fail could also be the cause.

Action

Make sure the space available for the output file is large enough to hold all the output. Re-running AR370 with the =warning run-time option may provide additional SAS/C Library diagnostics.

008

ERROR: Unable to replace original archive library-1 with the modified archive library-2.

Explanation

An attempt to replace the original archive library-1 with the new or modified archive library-2 failed. The original archive may be in an inconsistent or corrupted state. On some systems it may be possible to recover the members of the old archive from the modified archive.

A shortage of disk space is the most common cause for this failure but any file system problem or failure that might cause a rename or a close to fail could also be the cause.

010

ERROR: archive format unrecognized. Can not process file file-name.

Explanation

A file file-name specified as an archive did not contain a valid archive. Data read from the file was checked to verify it was an archive. If the archive has been modified by any utility other than AR370, then data could be lost or corrupted.

011

ERROR: invalid file name, file-name. Too many or misplaced parentheses.

Explanation

An input file name file-name was found to contain parentheses that were either out of order or repeated in the same name. Make sure only one set of parentheses is used in the name. The replace-as operator (=) could also cause this error if used incorrectly or as part of a name.

011

ERROR: invalid file name, file-name. No usable characters found in file name.

Explanation

An input file name file-name, was found to contain characters that were only delimiters or operators. Blanks and parentheses and the replace-as operator (=) are delimiters. The replace-as operator (=) could also cause this error if used incorrectly or as part of a name.

011

ERROR: invalid file name, file-name. No usable characters found in member name.

Explanation

An attempt to derive the archive member name or basename for the input file name file-name found characters that were only delimiters or operators in the archive member name or basename. Blanks and parentheses and the replace-as operator (=) are delimiters. The replace-as operator (=) could also cause this error if used incorrectly or as part of a name.

011

ERROR: invalid file name, string is not recognized as a file identifier.

Explanation

An attempt to process a command-line parameter string as a file identifier failed.

Action

Check the parameter string to make sure it is in the correct position and correctly specified.

011

ERROR: invalid file name, file-name. The replace-as operator requires a fully specified file identifier.

Explanation

CMS only: An incomplete file identifier was used with the replace-as operator. All input files to be added or replaced with an alternate member name must be completely specified. No defaults or wild cards can be used.

012

ERROR: invalid INCLUDE card in SYSIN. Card follows: card-text.

Explanation

A card read from the data set allocated to SYSIN did not contain a valid INCLUDE control statement, a blank line, or a comment (first character *). The contents of the card are echoed on the line after this message.

Action

Make sure all INCLUDE statements conform to the general form and syntax of linkage editor control statements.

013

ERROR: invalid SYMDEF card in file file-name.

Explanation

An AR370 SYMDEF control statement in the input file file-name contained invalid syntax. Other AR370 diagnostics that give more information on the error may precede this message.

Action

Check the SYMDEF control statement in the specified input file to make sure it conforms to the general form and syntax of linkage editor control statements. Make sure the symbol names are between 1 and 8 characters in length.

014

ERROR: invalid name for DD name DD-name.

Explanation

Under OS/390 only: the DD name DD-name from an INCLUDE statement was too long. Check the INCLUDE statements in SYSIN to make sure they conform to the general format of linkage editor control statements and are properly delimited.

014

ERROR: invalid name name specified as the alternate name for the DD name DD-name, must be between 1 and 18 characters in length.

Explanation

The alternate archive member name name for the specified input DD-name was too long. All alternate member names must be at least 1 character and no more than 18 characters in length.

Action

Make sure the replace-as operator = is in the correct position and check the SYSIN, INCLUDE control statements to make sure they conform to the general format of linkage editor control statements and are properly delimited.

014

ERROR: invalid name for symbol symbol specified in a SYMDEF control statement. SYMDEF symbols must be 1 to 8 characters in length.

Explanation

The symbol name symbol was too long. Symbols specified via SYMDEF control statements must be at least 1 character and not more than 8 characters in length.

Action

Check the symdef cards in the input object files.

014

ERROR: invalid name in replace-as operation input-string. Too many replace as operators used.

Explanation

More than one replace-as operator = was used when specifying the input_string. input-string is the target file name and its alternate archive member name. Archive member names that contain the replace-as operator = cannot be created.

015

ERROR: no members in archive.

Explanation

This message and a zero return code were the result of an attempt to display or type all members of an empty archive. If target members were specified, a nonzero return code will result.

Copyright © 2001 by SAS Institute Inc., Cary, NC, USA. All rights reserved.