|
PLAM libraries (Program Libraries)
Libraries of this type are also called program libraries. All data objects belonging to a particular project can be stored together in a PLAM library. The requirement for individual files is reduced, the size of the TSOSCAT is reduced, and data access will be accelerated.
PLAM library elements are identified by:
1) Element type (1 to 8 characters).
2) Element description (1 to 64 characters).
3) Version description (1 to 24 characters).
In CFS, the full description of an element may occupy up to 44 positions. These can be split amongst type, element and version descriptions.
In contrast to LMS, any type description may be used, up to 8 characters.
When adding elements to PLAM libraries, CFS can check the element for LMS type compatibility. Two possibilities exist:
a) Elements that are not compatible with LMS types are rejected.
b) The user is asked if the element should really be added as a non-compatible element.
Commands for controlling the Type check
CT Check Types. Only element types compatible with LMS may be added to PLAM libraries.
CTQ Check Types Query. Non-compatible element types need user confirmation before being added to a library (Standard).
NCT No Check Types. CFS does not perform any check.
LMS-compatible element types are:
C Core Image (program linked with TSOSLNK)
D Document/Data
H Module created by H Assembler
J JCL (DO/Enter procedures)
L Data created by the BS2000 binder
M Macro
P Print (list files printable with SPACE=E)
R Relocatable (Object module)
S Source
X Extra
Select all Elements protected with GUARD
GUARD The access type for files or PLAM library elements protected with Guard will be displayed (as from BS2000 V11.0).
R: Read access is protected with Guard
W: Write access is protected with Guard
X: Execute access is protected with Guard
The selection parameters Y | N can be used to select all those data objects with at least one access type protected with Guard, or those with no Guard protection.
The selection parameter [-] R|W|E [=name] can be used to select all data objects which have (or do not have) Guard protection with the specified name for the particular access type specified.
Selection parameter: Y | N | [-]R|W|E [=name]
Examples:
GUARD W
All files/library elements protected by a Guard against write access will be selected.
GUARD R=$TSOS.READGUARD
All files/library elements protected against read access with a Guard named $TSOS.READGUARD will be selected.
Select all Elements loaned by a User
HOLD Hold Status for PLAM elements. As from LMS Version 3.0, library elements can be loaned. This means that the userid of the borrower will be marked in the library table of contents. Only users logged in under this userid can amend or copy an identical or higher version of this element.
The HOLD User Option indicates the loan status of the individual elements. 'N' indicates that the element has not been loaned. If the element has been loaned, the userid of the borrower will be displayed.
Selection parameter: N | Y [:user-id] (user-id without $ and full stop)
Entering the selection parameter Y will result in all elements on loan being selected. Y:user-id will select all library elements on loan from a selected userid.
Notes:
Library elements can be loaned by means of the HOLD Action Code. The loan status can be reset with NHOLD. For further information, see page 6-.
For a full description of the HOLD function, refer to the LMS User Manual Version 3.0, Chapter 3 (Elements), Section 3.6 (Element/Data Protection), "Overview of Necessary Access Rights for LMS Actions".
Loan/Reset Loan Library Element
HOLD | NHOLD As from LMS Version 3.0, library elements can be loaned. This means that the userid of the borrower will be marked in the library table of contents. Only users logged in under this userid can amend or copy an identical or higher version of this element.
The Action Code HOLD results in the element being loaned. It is important under which userid the loan takes place.
The Action Code NHOLD results in the loan status for an element being reset.
Select Elements with the highest Version Number
VER The number of versions stored for the element will be displayed. Specifying the VER User Option will result in only the highest version of each element being displayed in the file list. This is particularly so for elements stored in non-Delta format. For Delta elements, only the highest version is displayed in the file list by default.
Adding Elements to a PLAM Library.
When adding files to a PLAM library, the element name will be constructed from the full file name, without the userid. The element type and the version description can be specified additionally. If the element type is not specified in the Add command, S/ will be assumed as a default. If the element version is not specified in the Add command, an existing element will have its highest version overwritten. New elements will have a default version description of /ß (X'FF') assigned.