Chapter 15. Invocation and Operation

Table of Contents
invocation
object files and module names
library options
default file names and extensions
help file search order
error level return

This section discusses invocation of LIBCOP, search order for help files, default filenames and extensions. See the release letter for installation instructions.

invocation

The invocation of LIBCOP is as follows:

libcop.exe libfile [objfile [,objfile...]] [/add] [/nobackup] [/delete] [/echo] [/list [=filename]] [/replace] [/update] [/nowarnings]

where:

libfile is the name of a library to process. If it does not already exist, then a new library is created. Default extension is .lib.
name is a list of one or more object files that are processed by LIBCOP. Default extension is .obj.
options is a list of library commands described in Section 4.4.

Note: MS-DOS supports @cmdfile, where cmdfile contains additional invocation line object filenames and/or options. This file has a default extension of .cmd.

Any error detected on the invocation line causes the Librarian to stop execution and display the part in error with an appropriate message.

The following are sample invocation lines:

	C:\COP8\NSASM\EXAMPLES>libcop.exe float sine,cosine /replace
	C:\COP8\NSASM\EXAMPLES>libcop.exe test dataset /delete
	

The first command line replaces the modules SINE and COSINE in the library float.lib by object files sine.obj and cosine.obj.

The second command line deletes the module DATASET from the library test.lib.