UEDTB1 is a user-written module that defines the two-character library identification codes used to refer to Com-plete source libraries. The module is loaded by the utility programs UED, UEDIT, and UPDS/USERV, and contains no executable logic.

The table is loaded by the utility programs. It can also be made resident in Com-plete's storage by specifying sysparm RESIDENTPAGE=UEDTB1 (z/VSE: this is done automatically by U2SPIT during startup). .

UEDTB1 is a set of macro statements, each of which defines a specific library and its assigned two-character code. Library security cannot be defined within UEDTB1, but a library code can be restricted to read-only status. If library security is desired, the ULSRSEC routine must be modified, or the appropriate user-written exit routine for the accessing program (e.g., UEDIT) must be written. All Com-plete utility programs that enable libraries to be accessed (e.g., UED, UEDIT, USERV, and UPDS) call the user-written exit ULSRSEC for this purpose. In addition, since these programs also load module UEDTB1, security can be established for entries in UEDTB1 in a generalized fashion without specific knowledge of the contents of the module (UEDTB1).

Dummy UEDTB1 modules are distributed with the Com-plete system as members of the distribution source library and the distribution load library.

This document covers the following topics:

• How to Use UEDTB1

• The CMEDTB1 Macro

---

How to Use UEDTB1

The library identification table UEDTB1 consists of three types of statements:

• TITLE;

• CMEDTB1;

• END.

The TITLE and END statements are standard Assembler language statements and are not discussed here.

The CMEDTB1 Macro

The CMDETB1 statement is a macro instruction, distributed in the Com-plete distribution source library, with the format:

CMEDTB1 ID=xx,DSN=library
       [,VSECAT=ccccccc]
       [,VSELIB=type]
       [,VSESUB=ssssssss]
       [,VOL=dddddd]
       [,OUTPUT=type]
       [,ACM=acm]
       [,USRDIS=YES|NO]
       [,STOW=YES|NO]

The arguments are:

ID=xx

Required.

Specifies the two-character library identification code to be assigned to the library being defined.

Here, xx is any two alphanumeric characters, the first of which must be alphabetic.

DSN=library

Required.

Specifies the name of the library identified by the two-character library code.

Note that library must be the same as the fully qualified cataloged library name. If the library is not cataloged, the optional argument VOL must be specified.

For LIBRARIAN and PANVALET libraries, library is the DD name associated with the LIBRARIAN or PANVALET file in the Com-plete initialization procedure.

Note:
LIBRARIAN and PANVALET libraries must be allocated by a job control allocation statement in the Com-plete initialization procedure. The DD name used must be specified by the DSN keyword argument.

For the PC access method, library can be used as a comment field.

VSECAT=ccccccc

Is used only for z/VSE; ignored for others.

Default: VSECAT=IJSYSCT

Specifies the file name for the VSAM Catalog for the specified library. The file name must be from one to seven characters and must be present in either standard-, partition-, or temporary-label before Com-plete startup.

VSELIB=type

Required for z/VSE; ignored for z/OS.

Default: VSELIB=NO

Specifies the type of z/VSE library to be defined in this entry. Possible values are:

AL	-VSAM library
BL	-non-VSAM library

Note:
In a z/VSE environment, the user must define a VSAM (AL) library to be accessed by Com-plete in either UEDTB1 or in an online definition by the UL function of UUTIL. If the library is not defined in UEDTB1 or via ULIB, it cannot be accessed via USERV, UMAP, UEDIT, or UED.

VSESUB=ssssssss

Is used only for z/VSE; ignored for others.

Default: *

Specifies the z/VSE sublibrary for the specified library. This value is a one- to eight-character sublibrary name.

VOL=dddddd

Optional

Specifies the volume serial number of the disk volume on which the library is to be found.

Default: If VOL is omitted, the system catalog is used to locate the file accessed.

Note:
Use this argument only if the library is not cataloged.

Note for z/VSE: Do not specify this argument if the library resides in VSAM space.

OUTPUT=type

Optional.

Default: OUTPUT=YES

Specifies whether or not the library being defined is read-only. type may be specified as YES or NO.

OUTPUT=YES indicates that the library is to be both input and output (that is, a SAVE operation can be performed).

OUTPUT=NO indicates that the library is to be input only (that is, the library cannot be modified).

ACM=acm

Optional.

Default: ACM=PO

Specifies the type of access method to be used to access the library being defined. Here, acm can be specified as PO, PS, PANVALET, LIBRARIAN, or PC.

ACM=PO indicates that the library is a partitioned file and the partitioned file access method is to be used.

ACM=PS indicates that the library is a sequential file and the sequential access method is to be used.

ACM=PANVALET indicates that the library is a PANVALET library and the PAN access method is to be used.

ACM=LIBRARIAN indicates that the library is a LIBRARIAN library and the LIBRARIAN access method is to be used.

ACM=PC indicates that the logical library is contained in a personal computer disk file and the PC access method is to be used.

USRDIS=YES|NO

Optional

Default: USRDIS=YES

USRDIS=NO prevents the display of STOW user data information.

STOW=YES|NO

Optional. (z/OS only.)

Default: STOW=YES

STOW=NO causes all STOWs from UED or UEDIT not to write Com-plete's user data.