LIB-UPDATE

File 5
Op-Sys z/OS, z/VSE, BS2000
Statement PROCESS
Task Perform library update functions, for example, rename, purge directory entries.

Common Fields for all Operating Systems

Dictionary Field Name F/L Mu DE Remarks
ERROR-CODE N3      
ERROR-TEXT A58      
NODE N5   D  
NODE-NAME A16   D  
SYSTEM-MESSAGE-CODE A10      
DSNAME A54   D Required.
FUNCTION A8   D Required.

Additional Fields Supported for z/OS

Dictionary Field Name F/L Mu DE Remarks
VOLSER A6   D Required only if the dataset is not cataloged.
MEMBER A10   D Required.
NEWNAME-MEMBER A10   D Relevant with FUNCTION=RENAME.
GENERATION N9   D Relevant with FUNCTION=SCRATCH.
PRODUCT A1   D  
ALIAS A8   D Relevant with FUNCTION=ALIAS.
ALIAS-EP B4   D Relevant with FUNCTION=ALIAS.
ALIAS-AMODE A3   D Relevant with FUNCTION=ALIAS.
PASSWORD A8   D  
MEMBER-PASSWORD A8   D Relevant when PRODUCT=L.
OPTIONS A80   D Relevant when PRODUCT=L.

Additional Fields supported for z/VSE

Dictionary Field Name F/L Mu DE Remarks
VOLSER A6   D Required.
LIBRARY A8   D Required.
SUB-LIBRARY A8   D Required.
MEMBER-TYPE A8   D  
NEWNAME-MEMBER-TYPE A8   D Relevant with FUNCTION=RENAME.
VSAM-CATALOG A8   D Required if VSAM-controlled Librarian file.

Additional Fields Supported for BS2000

Dictionary Field Name F/L Mu DE Remarks
PRODUCT A1   D  
PASSWORD A8   D  
SYSTEM-CODE B2   D  
ELEMENT A64   D  
NEWNAME-ELEMENT A64   D Relevant with FUNCTION=RENAME.
ELEMENT-TYPE A8   D  
NEWNAME-ELEMENT-TYPE A8   D Relevant with FUNCTION=RENAME.
ELEMENT-PASSWORD A8   D  
ELEMENT-VERSION A24   D  
NEWNAME-ELEMENT-VERSION A24   D Relevant with FUNCTION=RENAME.
OVERWRITE A3   D Relevant with FUNCTION=RENAME.
NEWNAME-ELEMENT-PASSWORD A8   D Relevant with FUNCTION=RENAME.
NEWNAME-ELEMENT-USER-DATE A14   D Relevant with FUNCTION=RENAME.
NEWNAME-ELEMENT-USER-TIME A8   D Relevant with FUNCTION=RENAME.

Relevant Error Codes

Code Text z/OS z/VSE BS2000
530 Access denied by Security Facility.     X
531 Password missing or incorrect.     X
541 Member generation not found in directory. X    
542 GENERATION not valid for this library. X    
543 GENERATION not valid for FUNCTION =:1:. X    
550 File not a PDS. X    
551 MEMBER not specified. X X X
552 NEWNAME / ALIAS missing. X X  
553 I/O error on directory. X    
554 Member not found. X X  
555 NEWNAME / ALIAS already exists. X X  
556 File is in use. X    
557 File held by linkage editor.      
565 Syntax error in dataset name.     X
572 Newname missing.     X
600 Unknown function. X X X
608 ISITMGD failed with RC :1: and reason :2:. X    
692 You are not permitted to access member.     X
697 Library/sublib not found.   X  
698 Internal Librarian error.   X  
699 Not enough main storage available. X X  
701 DSNAME missing.     X
772 Requested dataset not found.     X
798 Task was not started under TSOS.     X
799 Entire System Server internal error.     X
878 Volume defined as CA-Dynam/D pool name.   X  
989 Invalid element specification.     X
991 Unknown product. X   X
993 OPEN error. X    
998 Member not found.     X

Field Descriptions

Field Name Type/Length Operating System
ALIAS (A8) z/OS

Relevant with FUNCTION=ALIAS. Name of alias to be created.

Field Name Type/Length Operating System
ALIAS-EP (B4) z/OS

Relevant with FUNCTION=ALIAS. Entry point address to be assigned to the alias.

Field Name Type/Length Operating System
ALIAS-AMODE (A3) z/OS

Relevant with FUNCTION=ALIAS. AMODE to be assigned to the alias. Value can be one of 24, 31, 64 or ANY.

Field Name Type/Length Operating System
DSNAME (A54) z/OS, z/VSE, BS2000

Dataset name of the library to be updated.

Field Name Type/Length Operating System
ELEMENT (A64) BS2000

Element name.

Field Name Type/Length Operating System
ELEMENT-PASSWORD (A8) BS2000

Password for protected elements.

Field Name Type/Length Operating System
ELEMENT-TYPE (A8) BS2000

Type of element.

Field Name Type/Length Operating System
ELEMENT-VERSION (A24) BS2000

Version number of element to be updated.

Field Name Type/Length Operating System
FUNCTION (A8) z/OS, z/VSE, BS2000

Function to be performed. Possible options:

Option Explanation
ALIAS  Assign alias to existing member. (z/OS only)
RENAME  Rename member/element.
SCRATCH  Scratch member/element.
Field Name Type/Length Operating System
GENERATION (N9) z/OS

Generation number of member (only valid for PDSE version 2 with MAXGENS > 0).

Field Name Type/Length Operating System
LIBRARY (A8) z/VSE

Name of library.

Field Name Type/Length Operating System
MEMBER (A10) z/OS, z/VSE

Name of member to be processed.

Field Name Type/Length Operating System
MEMBER-PASSWORD (A8) z/OS

Password for protected CA-Librarian member.

Field Name Type/Length Operating System
MEMBER-TYPE (A8) z/VSE

Type of member.

Field Name Type/Length Operating System
NEWNAME-ELEMENT (A64) BS2000

Relevant with FUNCTION=RENAME. New element name.

Field Name Type/Length Operating System
NEWNAME-ELEMENT-PASSWORD (A8) BS2000

Relevant with FUNCTION=RENAME. Password, if an existing, password-protected element has to be overwritten with RENAME.

Field Name Type/Length Operating System
NEWNAME-ELEMENT-TYPE (A8) BS2000

Relevant with FUNCTION=RENAME. New element type.

Field Name Type/Length Operating System
NEWNAME-ELEMENT-USER-DATE (A14) BS2000

Is written as element information into the LMS library.

Format: YYYY-MM-DDaaaa, where aaaa can be any 4-character string.

Field Name Type/Length Operating System
NEWNAME-ELEMENT-USER-TIME (A8) BS2000

Is written as element information into the LMS library. Format: HH:MM:SS.

Field Name Type/Length Operating System
NEWNAME-ELEMENT-VERSION (A24) BS2000

Relevant with FUNCTION=RENAME. Version of new element.

Field Name Type/Length Operating System
NEWNAME-MEMBER (A10) z/OS, z/VSE

Relevant for FUNCTION=RENAME. New name of member.

Field Name Type/Length Operating System
NEWNAME-MEMBER-TYPE (A8) z/VSE

Type of new member when FUNCTION=RENAME.

Field Name Type/Length Operating System
OPTIONS (A80) z/OS

Options for CA-Librarian access method.

Field Name Type/Length Operating System
OVERWRITE (A3) BS2000

Relevant with FUNCTION=RENAME. Possible options:

Option Explanation
NO Default. Do not overwrite target element with the same name.
EXTEND Extend target element with this element.
ONLY Target element must exist.
YES Overwrite target element with the same name.
Field Name Type/Length Operating System
PASSWORD (A8) z/OS, BS2000

Password for protected dataset or file.

Field Name Type/Length Operating System
PRODUCT (A1) z/OS, BS2000

Access method used. Possible options:

Option Explanation
L CA-Librarian
M BS2000 LMS
P CA-Panvalet
Field Name Type/Length Operating System
SUB-LIBRARY (A8) z/VSE

Name of sublibrary.

Field Name Type/Length Operating System
VOLSER (A6) z/OS, z/VSE

Volume serial number.

Field Name Type/Length Operating System
VSAM-CATALOG (A8) z/VSE

Name of VSAM catalog where the library is kept.