Cancels one or more reservations of a generation of an element.
Format:
UNRESERVE element-expression "remark"
1 – Command Parameters
element-expression
Specifies one or more elements whose reservations are to be
canceled. An element expression can be an element name, a group
name, a wildcard expression, or a list of these separated by
commas.
remark
Specifies a character string to be logged in the history file
with this command, usually used to explain why the command was
entered. The remark is enclosed in quotation marks. If no remark
was entered, a null remark ("") is logged.
2 – Description
The UNRESERVE command cancels an existing reservation of a
generation of an element. You cannot unreserve a generation held
by another user unless you hold BYPASS privilege or unless you are
granted BYPASS access to the element by an access control entry.
If you have more than one reservation of an element, or if
you are replacing a concurrent reservation made by another user,
(that is, if there is any ambiguity), you must specify the exact
reservation to be canceled. You do this by using either the
/GENERATION qualifier or the /IDENTIFICATON_NUMBER qualifier.
You can use /GENERATION as long as the concurrent reservations are
not on the same generation. If you have more than one concurrent
reservation for the same generation, you must identify the
specific reservation to be canceled. Each reservation is assigned
an identification number. Use the SHOW RESERVATIONS command to
determine the identification number of each reservation. The
identification number appears in parentheses at the beginning
of each line. If you use the /IDENTIFICATION_NUMBER qualifier, you
do not need to also use the /GENERATION qualifier; when both are
used, CMS ignores the /GENERATION qualifier.
3 – Qualifiers
3.1 /CONFIRM
Controls whether CMS prompts you for confirmation before each
transaction.
When you specify /CONFIRM and run CMS in interactive mode, CMS
prompts you for confirmation. If you type YES, ALL, TRUE, or 1,
CMS executes the transaction. If you type NO, QUIT, FALSE, 0,
or press RETURN or CTRL/Z, no action is performed. If you type
any other character, CMS continues to prompt until you type an
acceptable response.
CMS does not prompt for confirmation in batch mode.
The /NOCONFIRM qualifier does not override the confirmation prompt
issued when you unreserve a concurrent reservation or when you
cancel another user's reservation.
3.2 /DELETE[=file-specification]
Controls whether all versions of the unreserved file are deleted.
If you omit /DELETE, the files are not deleted. If you specify
/DELETE without a file specification, all versions of the
unreserved files are deleted from your current directory. The
file specification allows you to specify a different location and
the name of the file to be deleted.
3.3 /GENERATION=generation-expression
Specifies which reserved generation of the element is to be
unreserved. If you have more than one reservation of the same
element generation, you must use the /IDENTIFICATION_NUMBER
qualifier to unreserve the reservation.
3.4 /IDENTIFICATION_NUMBER=n
Specifies which reservation is to be unreserved. This qualifier
is required when you have multiple reservations of the same
generation of an element. This qualifier is also required
when multiple users have reserved the same generation of an
element and you have BYPASS privilege or have been granted
BYPASS access to the element by an access control list entry.
/IDENTIFICATION_NUMBER can be used instead of /GENERATION
when you have multiple reservations. Use the SHOW RESERVATIONS
command to determine the identification number of each
reservation. The identification number appears in
parentheses at the beginning of each line.
3.5 /LOG (D)
Controls whether CMS displays success and informational messages
on the default output device. By default, if the command executes
successfully, CMS displays a success message. If you specify
/NOLOG, success and informational messages are suppressed. Any
warning, error, or fatal error messages are displayed regardless
of whether /LOG or /NOLOG is specified.
3.6 /OCCLUDE[=option,...]
Controls whether CMS selects the first instance of the specified
object, or all instances of the specified object in the library
search list. The options field contains one or more keywords
associated with the name of the object. The options field can
contain the following keywords:
ALL--equivalent to (ELEMENT, GROUP, CLASS)
ELEMENT (D)
NOELEMENT
GROUP (D)
NOGROUP
CLASS (D)
NOCLASS
NONE--equivalent to (NOELEMENT, NOGROUP, NOCLASS)
You can specify either ALL or NONE, or any combination of the
[NO]ELEMENT, [NO]GROUP, and [NO]CLASS keywords.
By default, CMS performs occlusion for all objects; that is, CMS
selects only the first occurrence of a specified object.
4 – Examples
(1) CMS> UNRESERVE FILEIO.BLI
_Remark: problem elsewhere
%CMS-S-UNRESERVED, element DISKX:[PROJECT.CMSLIB]FILEIO.BLI
unreserved
This command cancels the existing reservation of the element
FILEIO.BLI.
(2) $ SET PROCESS/PRIVILEGE=BYPASS
$ CMS UNRESERVE SAMPLE.TXT "unreserving on behalf of SMITH"
Element A.TXT currently reserved by:
(1) SMITH 1 17-FEB-1988 13:43:52 "sample module
for program"
Unreserve (1) SAMPLE.TXT generation 1, held by SMITH? [Y/N] (N): Y
%CMS-S-UNRESERVED, element DISKX:[SMITH.WORK.CMSLIB]SAMPLE.TXT
unreserved
This example shows the cancellation of another user's existing
reservation (through the use of BYPASS privilege) of the latest
generation of the element SAMPLE.TXT. If concurrent reservations
of element SAMPLE.TXT existed, you would need to specify the exact
reservation to be canceled by using either the /GENERATION or
/IDENTIFICATION qualifier.