Specifies the name of the library with the file you want to extract.
file-name
Specifies the name of the file. You can specify more than one file at a time.
Note: You must create all subdirectories required by a library before trying to extract files from the library. You can see what directories and subdirectories a library needs by using the PROLIB -list parameter to view the contents of the library.
When you extract a file from a library, PROLIB copies the file and places it in its original directory. Depending on how you add a file to a library, PROLIB extracts it differently. For example:
If you added the file by specifying a relative pathname, PROLIB searches your current working directory for the subdirectory indicated in the pathname. For example, if you added a file by using the relative pathname apps/proc1.r, PROLIB searches your current working directory for the subdirectory apps. If the directory does not exist, PROLIB displays an error message.
If you added the file by specifying its absolute pathname, PROLIB searches for the original directory. If the directory does not exist, PROLIB displays an error message.
Note: If you specify the -yank parameter instead of -extract, OpenEdge strips everything but the filename from the pathname and places the file in your current directory.
If the file you are extracting (or yanking) already exists in the directory outside of the library, PROLIB displays the following message (where file-name is the pathname of the file you are extracting or yanking):
File file-name already exists. Do you want to replace it?
Please answer 'yes' or 'no' or 'rename' to assign new name:
If you answer yes, PROLIB overwrites the file. If you answer no, PROLIB does not overwrite the file. If you answer rename, PROLIB displays the following message (where file-name is the pathname of the file you are extracting or yanking):
Enter new name to use for extracted file file-name -->
After you enter the pathname, PROLIB gives the file the new pathname and places it in the appropriate directory.
If you added the file by specifying a relative pathname, PROLIB searches your current working directory for the subdirectory indicated in the pathname. For example, if you added a file by using the relative pathname apps/proc1.r, PROLIB searches your current working directory for the subdirectory apps. If the directory does not exist, PROLIB displays an error message.