IS-LIBRARY( ) Check library name

Domain: Test functions

The IS-LIBRARY( ) function checks whether the specified file is entered in the catalog as a PLAM library.

If the file is not entered in the catalog as a PLAM library, IS-LIBRARY( ) supplies the result FALSE.

If the specified file does not exist, error handling is initiated.

See the “LMS” manual [11] for more information on working with PLAM libraries.

Format

IS-LIBRARY( )

FILE = string_expression

Result type

BOOLEAN

Input parameters

FILE = string_expression
“string_expression” designates a file name according to the SDF file type <filename 1...54>.

Result

TRUE
The file designated with the parameter FILE is entered in the catalog as a PLAM library.

FALSE
The file designated with the parameter FILE is not entered in the catalog as a PLAM library.

Error messages

No error messages

Example

/A = IS-LIBRARY('MY-LIBRARY')
/SHOW-VARIABLE A
/A = TRUE
/SHOW-FILE-ATTRIBUTES MY-LIBRARY,INF=ALL

The output from the SHOW-FILE-ATTRIBUTES command shows the complete catalog entry for MY-LIBRARY. The field TYPE contains the value PLAM-LIB.

%0000000012 :2OSG:$USER1.MY-LIBRARY

%  ------------------------------- HISTORY      -----------------------------
%  CRE-DATE   = 1996-06-03  ACC-DATE   = 2007-04-19  CHANG-DATE = 2006-06-04
%  CRE-TIME   =   13:41:01  ACC-TIME   =   10:51:10  CHANG-TIME =   12:34:10
%  ACC-COUNT  = 40          S-ALLO-NUM = 0
%  ------------------------------- SECURITY     -----------------------------
%  READ-PASS  = NONE        WRITE-PASS = NONE        EXEC-PASS  = NONE
%  USER-ACC   = OWNER-ONLY  ACCESS     = WRITE       ACL        = NO
%  OWNER      = R W X       GROUP      = R - X       OTHERS     = R - X
%  AUDIT      = NONE        FREE-DEL-D = *NONE       EXPIR-DATE = 2009-10-06
%  DESTROY    = NO         FREE-DEL-T = *NONE       EXPIR-TIME =   00:00:00
%  SP-REL-LOCK= NO          ENCRYPTION = *NONE
%  ------------------------------- BACKUP       -----------------------------
%  BACK-CLASS = A          SAVED-PAG  = COMPL-FILE  VERSION    = 2
%  MIGRATE    = ALLOWED
%  ------------------------------- ORGANIZATION -----------------------------
%  FILE-STRUC = PAM         BUF-LEN    = STD(1)      BLK-CONTR  = PAMKEY
%  IO(USAGE)  = READ-WRITE  IO(PERF)   = STD        DISK-WRITE = IMMEDIATE
%  TYPE       = PLAM-LIB
%  AVAIL      = *STD
%  WORK-FILE  = *NO         F-PREFORM  = *NONE       S0-MIGR    = *ALLOWED
%  ------------------------------- ALLOCATION   -----------------------------
%  SUPPORT    = PUB         S-ALLOC    = 24          HIGH-US-PA = 9
%  EXTENTS     VOLUME     DEVICE-TYPE      EXTENTS     VOLUME     DEVICE-TYPE
%      1       GVS2.1       D3435
%  NUM-OF-EXT = 1
%:2OSG: PUBLIC:      1 FILE  RES=        12 FRE=        3 REL=        3 PAGES