VLS Members and Utilities

VLS supports member names of up to 40 characters. Member names can contain embedded blanks. CA Ideal program, panel, report, dataview object, and data member entities all use 24‑character member names.

CA Ideal VLS Member Name Format

Since a site can use a single VLS library for storing various types of information, CA Ideal uses the following conventions internally to identify VLS members.

A type code in the 22nd position of the name identifies the member as:

'A'-Compiler encoded error messages
'B'-DB2 PLAN source
'D'-Dataview object
'H'-Help text member
'J'-Symbol table object
'K'-Sequential dataview source
'L'-Program PDL source
'N'-Compiler panel object
'P'-Parameter data source
'Q'-Parameter data object
'R'-Report specification
'T'-Program object
'U'-Panel specification
'V'-Working data object
'W'-Working data source
'Z'-Data member

Based on the member type, the following name formats are used:

Types            VLS Name 10        20        30        40
------      ----+----+----+----+----+----+----+----+
ALPRUW           sssxxxxxxxx.......vvvt.e
JNQTV            sssxxxxxxxx......pvvvtc.
D                $DVyyyyyyyyyyyyyyyvvvtcyyy
 -or-          $D2yyyyyyyyyyyyyyyvvvtcaaaaaaaayyy
K                yyyyyyyyyyyyyyyyyyvvvt.e
HZ               uuuxxxxxxxx..........t.e
B                $APppppppp...........t.e

sss-Three‑character system ID of the CA Ideal system containing the program, panel, or report.
uuu-Three‑character user ID of the data member's owner.
xxxxxxxx-One‑ to eight‑character program, panel, report, data member, or help member name, left‑adjusted and padded to the right with blanks if necessary.
yyyyyyyyyyyyyyy-15‑ or 18‑character dataview name.
aaaaaaaa-One‑ to eight‑character DB2 authorization‑ID for DB2 dataviews. Can be blank.
ppppppp-One‑ to seven‑character plan name for DB2.
vvv-Three‑digit version number in unsigned zoned format or the literal PRD for the PROD version of the program executable and symbol table objects.
t-One‑character type code, as specified above.
c-For source and panel library members, a blank (X'40').
For object library members, a one‑character sequence ID: A‑Z, 0‑9, X'01‑0E'. For all object types except the program executable object, there can be only one object member with a sequence ID of A.
e-One‑byte edit‑indicator to distinguish an EDIT session work‑ copy of a source member from the original.
Normally, this position is blank (X'40'), indicating that this is the original member. For object members, this position is always blank.

When editing a source member, a copy of the member is made with an E in this position. This work‑copy is used when a ROLLBACK operation is done, either as a primary command or as an option when editing a member that a previous EDIT session terminated abnormally. When an EDIT session ends normally, the work‑copy is deleted.

This position can also be R if the member is being deleted.

For data members (on library IDDAT) only, this position can be I if the member is under the control of an internal command.

For more information about using VLSUTIL and IDUTILITY, the Library Integrity Utility, see the Administration Guide.