CA-GSS Statements and Commands › Code Batch Maintenance Commands › NAME_LIST

Previous Topic: MAXCC

Next Topic: PACKAGE

NAME_LIST

In addition to operating on individual IMODs, many maintenance commands may operate on lists of IMODs. Use the NAME_LIST command to create and modify name lists.

Syntax

Use this format for the NAME_LIST command:

NAME_LIST &LISTn [CLEAR] [INCLUDE iset /pattern/]
                         [INCLUDE PDS ddname /pattern/]
                         [INCLUDE NAME name]
  [EXCLUDE pattern] [COPY &LISTn] [MERGE &LISTn] [PRINT]

Parameters

The NAME_LIST command takes these parameters.

Parameter

Description

&LISTn

Name of the list that is the target for the NAME_LIST operation. Three lists are available: &LIST1, &LIST2, and &LIST3.

CLEAR

Deletes the current contents of the list.

INCLUDE

Includes additional names in the list. Names are added only when they match the specified pattern.

iset

DDname of the ISET from which IMOD names are to be fetched.

ddname

DDname of the PDS from whose directory names are to be fetched.

name

Specifies a single name to be added to the list.

pattern

Comparison pattern to be applied against an IMOD name. The pattern may consist of both characters and placeholders. An asterisk (*) will match any single character. An ampersand (&) will match 0 through n characters. The pattern must be enclosed by a pair of arbitrary delimiter characters (shown as slashes (/) in the format). Any character that does not appear in the pattern except blank, VLDC, and FLDC may be used as the delimiter.

EXCLUDE

Any name in the list that matches the pattern will be deleted from the list.

COPY

Contents of the specified list replaces the target list.

MERGE

Contents of the specified list is merged into the target list. Duplicate names are discarded.

PRINT

Contents of the target list is printed.

Usage Notes