Displays all current reservations and concurrent replacements in effect at the time the command is issued. Format: SHOW RESERVATIONS [element-expression]
1 – Command Parameters
element-expression Specifies one or more elements for which CMS displays current reservation and concurrent replacement information. If you do not specify an element expression, information is displayed for all elements. An element expression can be an element name, a group name, a wildcard expression, or a list of these separated by commas.
2 – Description
The SHOW RESERVATIONS command provides information about current reservations and concurrent replacements. For each element that has one or more generations reserved, the output consists of the element name and the following: o For each reservation--identification number, user, reserved generation number, date, time, and remark o For each concurrent replacement--user, replaced generation number, date, time, and remark The elements are listed in alphabetical order.
3 – Qualifiers
3.1 /APPEND
Controls whether CMS appends the command output to an existing file, or creates a new file. If you specify /APPEND and the output file does not exist, CMS creates a new file. If you do not provide an output file specification (see the description for /OUTPUT), the output is appended to SYS$OUTPUT.
3.2 /BEFORE=date-time
Lists current reservations that were executed prior to the specified time. The date value can be an absolute, delta, or combination time value, or one of the following keywords: TODAY, TOMORROW, or YESTERDAY. By default, CMS displays all existing reservations.
3.3 /CONCURRENT
Lists only concurrent reservations and concurrent replacements.
3.4 /GENERATION[=generation-expression]
Lists reservations for a specific generation or set of generations in a class.
3.5 /NOREPLACEMENTS
Indicates that concurrent replacements are not to be displayed.
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.
3.7 /OUTPUT[=file-specification]
Directs CMS to write output to the specified file, except for any warning and error messages, which are written to SYS$OUTPUT and SYS$ERROR. CMS creates a new file if you do not specify /APPEND. If you omit the /OUTPUT qualifier (or if you specify /OUTPUT but do not provide a file specification), CMS directs output to the default output device (SYS$OUTPUT). If you omit either the file name or the file type component, CMS supplies the missing component from the default specification.
3.8 /SINCE=date-time
Lists current reservations that were executed after the specified time. The time value can be an absolute, delta, or combination time value, or one of the following keywords: TODAY, TOMORROW, or YESTERDAY.
3.9 /USER=username
Lists current reservations that were executed by the specified user. If you do not specify this qualifier, CMS lists reservations held by all users.
4 – Example
CMS> SHOW RESERVATIONS Reservations in CMS Library DISKX:[PROJECT.CMSLIB] AUDIT.FOR (2) STEVEW 8 25-APR-1988 09:46:38 "add checks for file attributes" Concurrent replacements STEVEM 9 16-MAY-1988 16:01:30 "change %ascid & non-picrefs to pic" GETCMD.FOR (1) STEVEM 15 17-MAY-1988 21:28:34 "fix access violation" INIT.FOR (1) SMITH 13 15-MAY-1988 15:09:33 "context reference--add_field" LSTUTL.FOR (1) STEVEM 5 17-MAY-1988 21:43:10 "bug fixes" This command lists the element name, the identification number of the reservation, the user who has it reserved, the generation number, and the date, time, and remark associated with the reservation for each element. In addition, CMS reports that the element AUDIT.FOR has been concurrently replaced, creating generation 9. As a result, user STEVEW must create a variant when he replaces the element.