LIB-UPDATE

#### Search Results

Search

# LIB-UPDATE

File | 5
Statement | `PROCESS`
Task | Perform library update functions, for example, rename, purge directory entries.

## Fields

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.
`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`.

## Relevant Error Codes

Code | Text
--- | ---
541 | Member generation not found in directory.
542 | GENERATION not valid for this library.
543 | GENERATION not valid for FUNCTION =:1:.
550 | File not a PDS.
551 | `MEMBER` not specified.
552 | `NEWNAME` / `ALIAS` missing.
553 | I/O error on directory.
554 | Member not found.
555 | `NEWNAME` / `ALIAS` already exists.
556 | File is in use.
600 | Unknown function.
608 | ISITMGD failed with RC :1: and reason :2:.
699 | Not enough main storage available.
991 | Unknown product.
993 | `OPEN` error.

## Field Descriptions

Field Name | Type/Length
--- | ---
`ALIAS` | (A8)

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

Field Name | Type/Length
--- | ---
`ALIAS-EP` | (B4)

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

Field Name | Type/Length
--- | ---
`ALIAS-AMODE` | (A3)

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
--- | ---
`DSNAME` | (A54)

Dataset name of the library to be updated.

Field Name | Type/Length
--- | ---
`FUNCTION` | (A8)

Function to be performed. Possible options:

Option | Explanation
--- | ---
`ALIAS` | Assign alias to existing member.
`RENAME` | Rename member/element.
`SCRATCH` | Scratch member/element.

Field Name | Type/Length
--- | ---
`GENERATION` | (N9)

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

Field Name | Type/Length
--- | ---
`MEMBER` | (A10)

Name of member to be processed.

Field Name | Type/Length
--- | ---
`MEMBER-PASSWORD` | (A8)

Password for protected CA-Librarian member.

Field Name | Type/Length
--- | ---
`NEWNAME-MEMBER` | (A10)

Relevant for `FUNCTION=RENAME`. New name of member.

Field Name | Type/Length
--- | ---
`OPTIONS` | (A80)

Options for CA-Librarian access method.

Field Name | Type/Length
--- | ---
`PASSWORD` | (A8)

Password for protected dataset or file.

Field Name | Type/Length
--- | ---
`PRODUCT` | (A1)

Access method used. Possible options:

Option | Explanation
--- | ---
`L` | CA-Librarian
`P` | CA-Panvalet

Field Name | Type/Length
--- | ---
`VOLSER` | (A6)

Volume serial number.

### On this page

- Fields
- Relevant Error Codes
- Field Descriptions