LIB-UPDATE

#### Search Results

Search

# LIB-UPDATE

File | 5
Op-Sys | z/OS, z/VSE, BS2000 Note Support for z/VSE is deprecated. Support for BS2000 is also deprecated, except in conjunction with the ESM adapter. Features that are z/VSE and BS2000 specific will be removed from future releases.
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.

### On this page

- Common Fields for all Operating Systems
- Additional Fields Supported for z/OS
- Additional Fields supported for z/VSE
- Additional Fields Supported for BS2000
- Relevant Error Codes
- Field Descriptions