DISPLAY PROCEDURE command: Procedure names

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.