Invoking ELIPS from a Program or CLIST › Invoking the Utility › UTIMAIN Parameter Keywords

UTIMAIN Parameter Keywords

The parameter keywords are:

FDSN

The data set name (including member name) as it would be entered on the utility FROM panel in the OTHER LIBRARIAN, PARTITIONED OR SEQUENTIAL DATA SET: field. If you omit the member name or specify a wildcard selection, a selection list displays. If you specify an asterisk (*) for the member name, all members are copied or moved.

TDSN

The data set name (including member name) as it would be entered on the utility TO panel in the OTHER LIBRARIAN, PARTITIONED OR SEQUENTIAL DATA SET: field.

PSWD

If required, supply the passwords for the FROM and TO members. For example, PSWD(ABCD,EFGH) or PSWD(ABCD) or PSWD(,EFGH).

MCD

If required, supply the management codes for the FROM and TO CA Librarian master files. See the Security Administration Guide for details on the MCD.

CMD

The ELIPS command is made up of both positional and keyword operands.

• {C|M}

  This operand is positional and mandatory. Specify C (copy) or M (move).

• ARC

  Optional keyword operand to specify the archive level. Code this operand as you would enter it on the utility FROM panel's ARC LVL field.

• OPT

  Optional keyword operand that represents the various fill-in fields found on both the utility FROM and TO panels. There are four sets of OPT keywords. You can code them in any order. You do not need to specify defaults. The four TO panel fields and associated options follow. The default options are underscored.

  REPLACE LIKE-NAMED MEMBERS
  

• REP or NOREP
• IF SEQ, TO D/S DISPOSITION
• OLD or MOD
• IF FROM PDS/SEQ. LIBRARIAN NUMBER
• OFF or COB or STD or DEF
• IF COB OR STD, USE EXISTING NUMS. FOR ADD
• USE or NOUSE

For example:

OPT(NOREP,STD)

This OPT parameter has the same effect as coding OPT(NOREP,OLD,STD,USE).

VAR

Represents the fill-in field REPLACE SLAT VARS found on the utility FROM panel. Code NO or YES (default is NO).

INC

Represents the fill-in field EXPAND INCLUDES found on the utility FROM panel. Code NO (the default) or YES.

RETURN

Specifies that UTIMAIN returns to the calling CLIST or program when the coded function is ended. When you do not specify RETURN, UTIMAIN returns to the utility entry panel.

The following is an example of invoking the utility from a CLIST through the ISPFEXEC SELECT service:

SELECT PGM(UTIMAIN) NEWAPPL(LIB@) NEWPOOL +
       PARM( +
            FDSN('LIBR.MMILLER.MAST2(ABC)') +
            TDSN(MMILLER.MAST(XYZ)) +
            PSWD(ABCD,WXYZ) +
            MCD(1234,5678) +
            CMD(C,ARC(900131102030),OPT(NOREP,MOD,COB,NOUSE),+
            VAR(YES),INC(NO)) +
            RETURN +
            )