SAS Component Language Dictionary |
Locks or unlocks a SAS table or a SAS catalog entry
sysrc=LOCK(member<,action>);
|
-
sysrc
-
contains the return code for the operation:
0 |
successful |
>0 |
not successful |
<0 |
the operation was completed, but
a warning or a note was generated. |
-
member
-
is a member of a SAS data library or a SAS
catalog entry. The value that you specify can be a one-, two-, three-, or
four-level name. A one-level name is presumed to be a libref, whereas a two-level
name defaults to the SAS table type DATA.
Type: Character
-
action
-
specifies an action to be performed on the
SAS table or catalog entry:
-
'CLEAR'
-
unlocks the specified SAS table(s) or SAS
catalog entry.
-
'LOCK'
-
locks the specified SAS table(s) or SAS
catalog entry. (This is the default.)
-
'QUERY'
-
queries the lock status of a SAS table or
a SAS catalog entry.
-
_SWNOLKH
-
not currently locked. SYSRC of -630099.
-
_SWLKUSR
-
locked by another user. SYSRC of -630097.
-
_SWLKYOU
-
locked or in use by the caller. SYSRC of
-630098.
Type:
Character
If action is not provided, the action defaults to LOCK.
Lock the data library that is associated with a libref
of A, unlock data view LIB.A, and lock LIB.A.B.PROGRAM. Then, query the lock
state of the FOO.ONE table:
rc=lock('a');
rc=lock('lib.a.view','clear');
rc=lock('lib.a.b.program');
rc=lock('foo.one.data','query');
if (rc=%sysrc(_SWLKUSR)) then
_msg_='Table foo.one is currently locked.';
Copyright © 2011 by SAS Institute Inc., Cary, NC, USA. All rights reserved.