DISPLAY PROCEDURE command: Procedure names

From m204wiki
Jump to navigation Jump to search

Summary

Privileges
Any user
Function
Displays procedure names

Syntax

DISPLAY [PROCEDURE] [(display-option [,display-option]...)] LIST [LIKE pattern]

Where:

display-option is one of the following:
Option Displays...

ALIAS

Aliases for each of your procedures, in addition to the official procedure names; listed in alphabetical order.

BRIEF

Procedure names only with procedure classes, if applicable. Each procedure name begins a new output line. Does not display the date, time, user ID, and length columns, or column headers.

COMPACT

Procedure names (and procedure classes, if classes are assigned) in compressed format, separated by commas. If aliases are requested, the procedure name and alias are separated by blanks.

If COMPACT is not specified, each procedure name begins on a new line.
HEADER

Column headings on the VERBOSE data. Column headings are the default when the VERBOSE format is used. The HEADER option is abbreviated HDR.

NOHEADER Suppresses the display of column headings when the VERBOSE format is used. This option is useful when the output of a DISPLAY command is routed to a USE data set, a Host Language program, or downloaded to a personal computer. The NOHEADER option is abbreviated NOHDR.

NOUSE

Procedure names on your terminal even if a USE command precedes the DISPLAY. Any alternate device is not used, but remains* open.

VERBOSE

Following information about the procedures in a currently open file or group (if the group has a PROCFILE):

Procedure name

Date of the last update to the procedure

Time of the last update to the procedure

ID of the last user to update the procedure

Length of the procedure in bytes

Procedure class

Name of the file to which the procedure belongs, if in multiple-procedure-file group context

This information is displayed in columns. VERBOSE is the default if no other format option is specified.
pattern is any of the pattern matching options described in detail in the Model 204 User Language Manual. For example, the following command displays the text of all procedures with names that begin with the string WEL:

DISPLAY PROC LIKE WEL*

The following command displays a list of all procedures with names that end with the string TEST:

DISPLAY LIST LIKE *TEST

The LIKE option is compatible with all valid types of pattern matching used in Like patterns in Finds.

Syntax notes

All combinations of the display options are allowed. Parentheses are required around display options. Display options can be separated by commas or by one or more blanks.

If COMPACT is specified with DISPLAY PROCEDURE LIST, Model 204 lists the procedure names, separated by commas, across the output line. COMPACT overrides the HEADER and VERBOSE options.

Only procedure names for which you have the user class to display are listed. Procedure classes can be displayed with the procedure names. A procedure class is a number associated with the procedure and has a value from 1 to 255.

The following examples apply to files created in Release 8.1 or later.

Example

This example displays the name, date, time, and length of all procedures:

DISPLAY LIST PROCEDURE NAME DATE TIME LENGTH USER ID PCL ACCT.REPORT 03/04/89 12:22:56 66 AC239 EXPENSE.AND.BUDGET.ANALYSIS.DISTRIBUTION.REPORT 05/29/88 17:08:41 987 AC239 MAIN.MENU 07/12/88 01:15:05 34 AC239 SAVINGS.EXTRACT 04/02/88 08:44:10 7764 AC239

The following example lists the names of procedures and suppresses the display of the date, time, user ID, and length columns. The procedure class column would still be displayed:

DISPLAY (BRIEF) LIST ACCT.REPORT EXPENSE.AND.BUDGET.ANALYSIS.DISTRIBUTION.REPORT MAIN.MENU SAVINGS.EXTRACT

Usage notes

This form of the DISPLAY PROCEDURE command displays the names of a user's procedures. The output of the DISPLAY PROCEDURE command is sorted by procedure name whenever LIST is specified.

Model 204 lists the names of all procedures to which you have display or use access privileges. Procedure names are listed in the format specified by the display options.

The DISPLAY PROCEDURE LIST command can be used to display information about procedures in a currently open file or group (assuming that the group has a PROCFILE).

The options VERBOSE, BRIEF, HEADER, and NOHEADER take effect when LIST is specified. The options enable you to choose the amount and form of the information to be displayed.

The display format is as follows:

Information

Appears in column...

Procedure name

1 through 29.

If the procedure name exceeds 29 characters, the name continues in column 30 through the value of the OUTCCC parameter minus 1. The procedure name then continues on the next output line, if necessary. The date, time, and length appear on the first output line where column 30 is available.

Date of the last update

31 through 38.

Time of the last update

40 through 47.

Length of the procedure in bytes

49 through 54.

ID of the last user to update

56 through 65.

Security class

67 through 69.

Name of the file to which the procedure belongs, if in multiple-procedure-file group context

71 through 78.

If the ALIAS option is specified and a procedure has an associated alias or aliases, the aliases appear on the output lines that follow the line displaying the date, time, and length information for the procedure. Each alias begins a new output line. The display of an alias begins in column 5.

If the procedure has a procedure security class, and you are allowed to display the procedure, then the procedure security class appears in columns 67 through 69.

The format is the default display format for both full screen and line-at-a-time terminals if the file was created in Release 8.1 or later. If the OUTCCC parameter is set to a value less than 70, the display lines wrap to fit in the available display area.

The date, time, user ID, and length information for each procedure is stored in the procedure dictionary of the file that contains the procedure. Model 204 initially stores this information in the file the first time the procedure is defined in the file. Model 204 updates the procedure information each time the procedure is updated.