Requests from a terminal to execute an online program must normally be preceded by an asterisk (*). You can use different characters when invoking programs under COM-PASS. (See the section entitled COM-PASS Terminal User Information.) The asterisk as the first character signals to Com-plete that the information following is a request for execution of a user or Com-plete program. Note that utilities are considered to be Com-plete programs.

The general format for executing a program from a Com-plete terminal is:


where program is the one- to eight-character name of the program to be executed. Note that this program must reside in the Com-plete program library.

In some cases, arguments can be passed to an online program when the program is initially called for execution, in the format:

*program argument 

where argument represents one or more arguments to be passed.

In this documentation, each command that invokes a Com-plete utility program is shown in a statement illustrating the proper format for that command. Note that program names and arguments in upper-case must be entered exactly as illustrated. Lower-case arguments indicate that a substitution must be made if that argument is used. Valid substitutions for each argument are described in the appropriate section for each command.

Brackets, [ ], curly braces, { } , and vertical bar(s), |, are used to illustrate command syntax in this documentation.

Do not type brackets, curly braces, or vertical bars as part of the command.

Brackets, [ ], indicate that the keyword, argument, or value is optional. When more than one option is given within one set of brackets, you can select one or more.

Braces, { }, indicate that a choice of enclosed items must be made. Note that one, and only one, of the values between the braces must be supplied.

The vertical bar, |, separates the selectable options.

Example 1

The format for a typical ULIB request is:

*ULIB DIS,PGM=program 

When you enter this command at a terminal, you must enter the upper-case words and symbols as shown. In addition, you must supply the name of the program for which information is requested.

An example of the use of this command is:

Example 2

The format for a ULIB catalog request for programs is:

*ULIB CAT,program[,RG=nK]

The square brackets indicate that the RG keyword can be omitted.

A typical command to catalog a program is: