AR370(1) — USER COMMANDS
NAME
ar370 − creates and maintains portable archives or libraries
USAGE
ar370 cmds [ posname ] archive_name [ name ] ...
DESCRIPTION
ar370 the SAS/C object code library management utility creates and maintains groups of files in portable archives or libraries. Its main use is to create and update archive files to be used by the SAS/C linker as autocall libraries (see clink(1) ). The internal format used by ar370 archives is stored in EBCDIC characters.
Individual files are included without changes, in the archive file, and the archive file is portable across machines. When ar370 creates or updates an archive, it creates an archive symbol table that allows SAS/C linker ( clink ) to search the archive efficiently for symbols and resolve SAS/C extended names when resolving names from an ar370 archive (see clink(1) ).
cmds must be present, and consists of an optional -, followed by one command character from the set dmrx and, or t, optionally concatenated with one or more of the command modifier characters from the set abejv.
posname is the name of a specific library member and is required only if one of the relative positioning command modifiers is specified.
archive_name is the archive file name and must be present.
name ... specifies the filename(s) of the file(s) to be added or replaced or the name(s) of the archive members to be otherwise manipulated. Archive member names must be specified exactly as they appear in the archive.
OPTIONS
The following command characters are recognized:
d Delete the named members from the archive file.
m Move the named members. By default, the members are moved to the end of the archive. If an optional positioning character from the set abi is used, the posname argument must be present and specifies that the moved members are to be placed after (a) or before (b) posname. Note that, when used with a positioning character, the members are moved in the same order that they currently appear in the archive, not in the order specified on the command line.
r Replace the named members, or add a new file to the archive. If an optional positioning character from the set abi is used, the posname argument must be present and specifies that new files are to be placed after (a) or before (b or i) the posname member. In the absence of a positioning character, new members are placed at the end. ar370 creates a archive file if it does not already exist. If no files are specified by name arguments, ar370 creates an empty archive file.
t Type a description of the contents of the archive. If no member names are specified, all members in the archive are described by name. If a member or members are specified, information about only those members appears. Additional information is produced when the (v) and (e) command modifiers are also specified.
x Extract the named archive members. If no names are specified, all members of the archive are extracted. In neither case does this alter, i.e. delete entries from, the archive.
The following optional modifiers are recognized:
a After. Members moved or replaced are positioned after the posname argument which must also be present. Note: some versions of ar use -A to suppress warning messages regarding optional access control list entries. ar370 does not.
b Before. Members moved or replaced are positioned before the posname argument which must also be present.
e Enumerate. only meaningful in combination with the (t) type command. Lists the definition symbols that represent a definition in each of the members specified for the type command. When also used with the (v) verbose command all symbols in the specified members are displayed.
j Japan, or upper case. All output is capitalized.
l Local. Temporary files are placed in the local current working directory rather than in the directory specified by the environment variable TMPDIR or in the default directory /usr/tmp. Only meaningful with the d, m, and r commands.
v Verbose. Enables certain types of output from commands. When used with t, v gives a long listing of information for each specified member in the form of name, date, size and number of symbols. If no members are specified
When used with the d, m and x operations, the verbose modifier causes ar370 to print each command operation character and the member name associated with that operation. For the r operation, ar370 shows an "a" if it adds a new file or an "r" if it replaces an existing member. The verbose command also enables output of ar370’s title and copyright notice.
Only the following combinations are meaningful;
command: accepted modifiers and commands
d: e, j, t, v
m: e, j, t, v and a | b
r: e, j, t, v and a | b
t: e, j, t, v
x: e, j, t, v
EXTERNAL INFLUENCES
EnvironmentVariables
The TMPDIR environment variable can be set to specify a directory for temporary files (see tmpnam(3S)). The l modifier can be used to override the TMPDIR variable, and TMPDIR overrides the default directory /usr/tmp.
DIAGNOSTICS
All warning and error messages will be composed of a prefix of "LSCA", followed by the message number, then either "WARNING:" or "ERROR:", and a brief description of the problem. For example:
LSCA002 WARNING: unable to find move target.
In some cases such messages may be followed by a message produced by a call to perror (see perror(3C)).
EXAMPLES
Create a new archive named testlib.a that contains files f1, f2, f3, and f4 with:
ar370 r testlib.a f1 f2 f4 f3
Display the members of the new archive in order with:
ar370 t testlib.a
Move the members f1 and f2 to the end of the order with:
ar370 m testlib.a f2 f1
Display the member f3 of the new archive and all symbol it contains with:
ar370 tve testlib.a f3
Delete the members f1 and f1 from the new archive with:
ar370 d testlib.a f1 f2
Replace the members f3 and f4 of the archive with:
ar370 r testlib.a f3 f4
CAUTIONS
ar370 archives are created and maintained only by ar370. The internal structures and the data they contain are in EBCDIC. ar370 archives should never be modified or accessed in any way, other than through ar370.
FILES
/usr/tmp/ar∗ temporary files
ar370ar370 program
SEE ALSO
RELATED INFORMATION
sascc370(1), SAS/C Compiler and Library User’s Guide.
5.50 — Last change: SAS/C