| name | find-library-server |
| description | Verify that a SAS Viya library exists and determine which server (CAS or SAS) hosts it. Always checks CAS first, then SAS. Returns the confirmed library name and server. Use whenever you need to confirm a library exists before listing tables or performing any library-scoped operation.
|
Find Library Server
Purpose: Verify a library exists and determine whether it lives in CAS or SAS.
Tool: sas-score-find-library({ name, server })
Workflow
-
Call sas-score-find-library({ name: "<lib>", server: "cas" })
- ✅ Found → return
{ lib: "<lib>", server: "cas" }
- ❌ Not found → go to step 2
-
Look in SAS
- Uppercase the library name
- call
sas-score-find-library({ name: "<LIB_UPPERCASED>", server: "sas" })
- ✅ Found → return
{ lib: "<LIB_UPPERCASED>", server: "sas" }
- ❌ Not found → library does not exist; stop and report not found to the user
Known Library Hints (skip searching if known)
Use these to skip the two-step search when the server is already deterministic:
| Library (case-insensitive) | Server |
|---|
| Casuser, Formats, ModelPerformanceData, Models, Public, Samples, SystemData | "cas" (check CAS only) |
| MAPS, MAPSGFK, MAPSSAS, SASDQREF, SASHELP, SASUSER, WORK | "sas" (check SAS only, uppercase lib) |
| Unknown | Try CAS first; if not found, try SAS with uppercased lib |
Output
Always return the confirmed resolved values to the caller:
| Field | Value |
|---|
lib | Confirmed library name (may be uppercased for SAS) |
server | "cas" or "sas" |
Error Handling
- Not found in either server → confirm spelling with the user and offer to list available libraries.
- Do not fall back to listing libraries as a substitute for verification — they serve different purposes.
Important Constraints
- Never use
list-* tools for library verification — use only sas-score-find-library.
- This skill verifies libraries only. To verify a table, use
sas-score-find-table directly (it validates the library implicitly).
