DELTA COMMAND SUMMARY
LEMUR COMMANDS
LEMUR (Library Editor and Maintenance Utility Routine) is a processor that builds and manipulates ROM and load module libraries. The libraries thus built are accessed by LYNX or Load when constructing user programs (load modules) which rE~quire library routines. LEMUR is avail-able in both on-line and batch modes.
LEMUR allows the user to
• Construct a library ROM module out of specified ROMs.
• Construct a library load module out of specified ROMs.
(A I ibrary load module must be of one protection type.)
• Have more than one library per account.
• Delete a specified portion of a library and all refer-ences ta that portion in' the dictionary.
• Delete a library.
• Copy a library module from library to another.
• Copy a library to another library.
CALUIG LEMUR
LEMUR is invoked in the on-line mode by the TEL command
! LEMUR
When invoked, LEMUR identifies itself and prompts with a greater than (» character. All commands are read through the M:SI DCB and out'put is through the MILL DCB.
Commands are relatively free-format; i.e., blanks are ignored except as delimiters. If a semicolon is encountered in a command line, all subsequent characters in that line are ignored and the next input line is treated as a contin-uation line. A command line beginning with an asterisk (*) is treated as a comment.
LEMUR COICEPTS
The following conventions are used in LEMUR:
1. Names of library modules and DEFs consist of a string of any of th~ following characters:
A-Z a-;z 0-9 $*%:@#
They may also consist of a string of the above characters enclosed within single" quotes. A library load module name cannot exceed 11 characters. A DEF cannot exc~ed 14 characters.
150 • LEMUR
2. A file identification has the standard format with the exception that the name, account, or password may be a string of characters enclosed within single quotes.
The name portion of a file identification cannot ex-ceed 10 characters if it identifies a ROM which is to
be
part of a library load module.3. A rom-id is the file identificotion of a ROM.
4. A lib-id is the file identification of a library.
5. The term "destination library" is defined to be the library specified by the LIBRARY commond. This is the library on which the user wishes to work.
6. The term "default library" implies the :L1B library.
If library name is missing from a command in which lib-id is optional, then :lIB is assumed by default.
Also, if the LIBRARY command is not used in a LEMUR session, the default and the destination library are the same (:lIB).
7. The term "library module" refers to a named collection of one or more ROMs or a load module which has been entered into the library via a BUILD or a CARRY com-mand. The module gets its ''name II when it is entered in this manner.
LEMUR COMMANDS
UBRARY The library command specifies the destina-tion library (i. e
0,
the I ibrary on wh ich the user wishes to work). The format of the command isLIBRARY [nameH. [accountJ[. password]}
where name, account and password have their usual mean-ings. If name is omitted, the default is :LlB. If account is omitted, the default is the user's account.
BUILD The BUILD command constructs a library module and enters it into the destination library. The library mod-ule constructed_may either be a load modmod-ule or a ROM module, depending pn specifications within the command.
The format of the command is
BUILD name FROM ram-id[,rom-id) ••
oJ
[ [(option)[.(option») ••• ) where
name specifies the name of the library modules to be constructed. If the module name already exists in the destination library, it is deleted and the new version is constructed and entered 0
rom-id specifies the name of a ROM to be used in the construction of the load module or ROM library module.
90 09 07H-l(9/78)
If the name already exists, all old dictionary entries which specified, the module being constructed will consist of the ROMs specified by the rom-id's in ROM form. This
'(DREF) specifies that all dummy section definitions should be changed to PREFs. This allows a library to be built in which all references to a particular named DSECT will be linked to a single copy of that DSECT (e.g., a FORTRAN BLOCK DATA subprogram). Such initialized dummy sections should be contained in a library ROM module or
>BUILD LR4 FROM R5,R6(SL,4)(M)~,")
>END(.";
the deleted module are removed. The format of the
where lib-id specifies the source library. (The destination library was either specified on a LIBRARY command or is :LlB by default.)
The source and destination libraries must be different (i.e., different names or different accounts or cofifferent fibnuy names in the same account).
lib'id specifies the source library. (Thedestina-tion library was either specified on a LIBRARY command or is : LIB by default.)
name2 specifies the module name in the source . library. If it is omitted, the source module is assumed to be the same as name 1 by defaul t.
The source and destination libraries must be different (i .e., different accounts or different library names in the source library and entered into the destination library.
If a symbol in the name module already exists as a
(Omission of a LIBRARY command Implies that the destination library is to be :LlB.A55 by default.
Omission of the source library name implies :LlB by defaul t . )
4. The user violates the rule that the source and destina-tion I ibraries must be different.
1
LEMUR@)? CARRY ZAP FROM :Ll8/MAP~"0
? END~~
An error message is issued and the command is aborted.
EIO The END command terminates LEMUR and returns control to TEL. The format of the command is
END
ERROR MESSAGES
Tab 1-:.
35.
LEMUR Error MessagesMessage Meaning
")" MISSING AFTER OPTION Self-explanatory.
ACCOUNT NAME TOO LONG The account name exceeds eight characters.
BAD FILE I. D . Self-explanatory.
BAD QUOTE STRING An illegal character occurred within a string.
CAN'T CREATE LIBRARY An I/O error occurred when trying to create a new library.
CAN'T OPEN FILE Either the ROM id doesn't exist, the module doesn't exist (DELETE), or the source module doesn't exist (CARRY).
CAN'T OPEN LIBRARY An I/O error occurred when trying to open an existing library.
COMMAND TOO LONG A command (including continuations) is too long for LEMUR's command buffer of 256 characters.
EH? A command is malformed.
FILE NAME TOO LONG A fi Ie name exceeds ten characters.
GARBAGE AT END OF LINE A command contains unrecognizable characters 0
I/O ERROR Se I f-explanatory •
ILLEGAL CONTINUATION UNE Self-explanatory.
I LLEGAL LIBRARY FORMAT A reference to a file which is supposed to contain a library was made in a LEMUR command I but the fi Ie is not in I ibrary format.
ILLEGAL OPTION FOR THIS COMMAND Se! f-explanatory.
I LLEGAL ROM LANGUAGE The ROM is malformed.
I LLEGAL ROM RECORD HEADER The ROM is malformed.
ILLEGAL ROM RECORD LENGTH The ROM is malformed.
LIBRARY NAME MISSING A required library name is missing in a command.
90 09 07H-I(9/78) LEMUR 153
Table 35. LEMUR Error Messages (cont.) Message
LIBRARY NAME TOO LONG MALFORMED OPTION
MAXIMUM SEVERITY LEVEL EXCEEDED
MISSING FILE NAME MODULE NAME MISSING
NOT ENOUGH CORE
NOT ENOUGH SYMBOL SPACE
PASSWORD TOO LONG
SOURCE SAME AS DESTINATION LIBRARY
UNEXPECTED END OF ROM UNKNOWN COMMAND UNKNOWN OPTION
YOU USED THE SAME OPTION TWICE
Meaning
A library lood module name exceeds 11 characters.
Self-explanatory •
The severity level specified by the SL option has been exceeded.
A .required file name is missing In a command.
A required module name is missing in a command.
there Is insufficient common or virtual memory to satisfy the requirements for I/O buffers used in the COpy and CARRY commands.
The space required by LEMUR to construct the dictionary is insufficient.
The password exceeds 8 characters.
The requirement that the source and destination libraries be different on the COpy and CARRY commands has been violated.
The ROM Is malformed.
Sel f-explanatory.
Self-explanatory.
Se I f-e~planatory .
COMMAIO SUMMARY