Chapter Contents |
Previous |
Next |
SAS/C Cross-Platform Compiler and C++ Development System User's Guide, Release 6.50 |
The
ar370
archive utility is invoked directly with the following command:
ar370 cmds [posname] libname [fname...]The cmds argument must be specified, and consists of an optional -, followed by one of the command characters
d
,
m
,
r
,
x
, or
t
. (
t
may be specified with any other command.) Optionally, you can concatenate the command character with one or more of the command modifier characters
a
,
b
,
e
,
j
,
q
, or
v
. The command and command modifier characters are described later in this section.
The libname argument specifies the filename of the archive
library and must be present. By convention, an extension of
.a
is used to identify archive library files.
One common use of the
ar370
archive utility is to replace or add files to an archive. In the following example, the utility is invoked to replace the members
run.txt
and
walk.txt
in the
ar370
archive named
zoom.a
. Verbose output is requested.
ar370 rv zoom.a run.txt walk.txt
If either
run.txt
or
walk.txt
does not exist in the
zoom.a
archive, it is added to the archive by the
r
command character.
ar370 r mylib this.text.a1=that.objThis command stores the file
this.text.a1
in the archive
mylib
with the member name
that.obj
.
Command Characters |
The following command characters are recognized:
Optional Modifier Characters |
The following optional modifier characters are recognized:
Modifier
Characters
|
Description |
---|---|
a
|
Positions the members to be moved or replaced after the member specified by the posname argument. If you
specify
a
, you must specify posname. |
b
|
Positions the members to be moved or replaced before the member specified by the posname argument. If you
specify
b
, you must specify posname. |
e
|
Enumerate: Lists the defined symbols for the members specified for the
type
command. This modifier is meaningful only when used with the
type
(
t
) command. When used with the
verbose
(
v
) command modifier, all symbols (defined and referenced) in the specified members are displayed. |
j
|
Japan or uppercase: Produces all output in uppercase (
japan
). |
q
|
Quick: Processes members of existing archives more quickly. This option keeps
ar370
from reprocessing every member in the archive. It greatly reduces the amount of I/O needed to add, replace, delete, and move members in an archive, since no work file is used. You should use this
option with care, however, because an existing library containing data could be destroyed if space in the data set runs out. Prior to
using
ar370
with the
q
option, we recommend that you back up the archive so that you will not lose your data in the event that the original dataset is destroyed.
Note: The
|
|
|
v
|
Verbose: When used with
t
, the
v
command modifier produces 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, a listing is produced for all
members in the archive.When used with the
d
,
, or
modifiers, the
modifier causes the
archive utility to print each command modifier character and the member name associated with that operation. For the
modifier, the
archive utility shows an
if it adds a new file or an
if it replaces an existing member. The verbose modifier also produces the
archive utility's title and copyright notice. |
Combinations of Commands and Modifiers |
Only the combinations of commands and command modifiers shown in the following table are meaningful.
Command | Accepted Modifiers and Commands |
---|---|
d
|
e
,
f
,
j
,
q
,
t
,
v
|
m
|
e
,
f
,
j
,
q
,
t
,
v
and
a
|
b
|
r
|
e
,
f
,
j
,
q
,
t
,
v
and
a
|
b
|
t
|
d
,
e
,
f
,
j
,
m
,
r
,
v
,
x
|
x
|
e
,
f
,
j
,
t
,
v
|
Chapter Contents |
Previous |
Next |
Top of Page |
Copyright © 1998 by SAS Institute Inc., Cary, NC, USA. All rights reserved.