DISPLAY PROCEDURE command: Procedure names: Difference between revisions

From m204wiki
Jump to navigation Jump to search
No edit summary
mNo edit summary
Line 6: Line 6:
<dd>Displays procedure names
<dd>Displays procedure names
</dl>
</dl>
==Syntax==
==Syntax==
<p class="syntax"><b>D</b>ISPLAY [<b>PRO</b>CEDURE]  
<p class="syntax"><b>D</b>ISPLAY [<b>PRO</b>CEDURE]  
Line 15: Line 16:
<table>  
<table>  
<tr>
<tr>
<th>display-option</th>
<th nowrap>display-option</th>
<td> is one of the following:
<td> is one of the following:
<table>
<table
<tr class="head"> <th>Option</th> <th>Displays...</th> </tr>
    
    
<tr> <th>Option</th> <th>Displays...</th> </tr>
<tr> <th><var>ALIAS</var></th>  
 
<td>Aliases for each of your procedures, in addition to the official procedure names; listed in alphabetical order.  </td> </tr>
<tr> <th><var>
<p>ALIAS</p>
</var></th> <td>Aliases for each of your procedures, in addition to the official procedure names; listed in alphabetical order.  </td> </tr>
   
   
<tr> <th><var>
<tr> <th><var>BRIEF</var></th>  
<p>BRIEF</p>
<td>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. </td> </tr>
</var></th> <td>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.   </td> </tr>
   
   
<tr> <th><var>
<tr> <th><var>COMPACT</var></th>  
<p>COMPACT</p>
<td>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.
</var></th> <td>
<p>
<p>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.</p>
If <var>COMPACT</var> is not specified, each procedure name begins on a new line. </p></td> </tr>
If COMPACT is not specified, each procedure name begins on a new line.   </td> </tr>
   
   
<tr> <th><var>HEADER </var></th> <td>
<tr> <th><var>HEADER</var></th>  
<p>Column headings on the VERBOSE data. Column headings are the default when the VERBOSE format is used. The HEADER option is abbreviated HDR. </p>
<td>Column headings on the <var>VERBOSE</var> data. Column headings are the default when the <var>VERBOSE</var> format is used. The <var>HEADER</var> option is abbreviated <var>HDR</var>. </td> </tr>
</td> </tr>
   
   
<tr> <th><var>NOHEADER</var></th> <td>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.       </td> </tr>
<tr> <th><var>NOHEADER</var></th>  
<td>Suppresses the display of column headings when the <var>VERBOSE</var> format is used. This option is useful when the output of a <var>DISPLAY</var> command is routed to a USE data set, a Host Language program, or downloaded to a personal computer. The <var>NOHEADER</var> option is abbreviated <var>NOHDR</var>. </td> </tr>
   
   
<tr> <th><var>
<tr> <th><var>NOUSE</var></th>  
<p>NOUSE</p>
<td>Procedure names on your terminal even if a USE command precedes the DISPLAY. Any alternate device is not used, but remains* open. </td> </tr>
</var></th> <td>
<p>Procedure names on your terminal even if a USE command precedes the DISPLAY. Any alternate device is not used, but remains* open.   </p>
</td> </tr>
   
   
<tr> <th><var>VERBOSE</var></th> <td>
<tr> <th><var>VERBOSE</var></th>  
<p>Following information about the procedures in a currently open file or group (if the group has a PROCFILE):</p>
<td>The following information about the procedures in a currently open file or group (if the group has a PROCFILE):
<p>Procedure name</p>
<ul>
<p>Date of the last update to the procedure</p>
<li>Procedure name</li>
<p>Time of the last update to the procedure</p>
<li>Date of the last update to the procedure</li>
<p>ID of the last user to update the procedure</p>
<li>Time of the last update to the procedure</li>
<p>Length of the procedure in bytes</p>
<li>ID of the last user to update the procedure</li>
<p>Procedure class </p>
<li>Length of the procedure in bytes</li>
<p>Name of the file to which the procedure belongs, if in multiple-procedure-file group context</p>
<li>Procedure class </li>
This information is displayed in columns. VERBOSE is the default if no other format option is specified. </td> </tr>
<li>Name of the file to which the procedure belongs, if in multiple-procedure-file group context</li>
 
</ul>
This information is displayed in columns. <var>VERBOSE</var> is the default if no other format option is specified. </td> </tr>
</table>
</table>
</td>
</td>
Line 64: Line 59:
<tr>
<tr>
<th>pattern</th>
<th>pattern</th>
<td> is any of the pattern matching options described in detail in the <var>Model&nbsp;204 User Language Manual</var>. For example, the following command displays the text of all procedures with names that begin with the string WEL:  
<td>Any of the pattern matching options described in detail in [[Record retrievals#Pattern matching|Pattern matching]]. For example, the following command displays the text of all procedures with names that begin with the string <code>WEL</code>:  
<p class="code">DISPLAY PROC LIKE WEL*
<p class="code">DISPLAY PROC LIKE WEL*
</p>
</p>
<p>The following command displays a list of all procedures with names that end with the string TEST: </p>
<p>
The following command displays a list of all procedures with names that end with the string <code>TEST</code>: </p>
<p class="code">DISPLAY LIST LIKE *TEST
<p class="code">DISPLAY LIST LIKE *TEST
</p>
</p>
<p>The LIKE option is compatible with all valid types of pattern matching used in [[Record retrievals#likeSyntax|Like patterns in the Find statement]].</p>
<p>
The <var>LIKE</var> option is compatible with all valid types of pattern matching used in [[Record retrievals#likeSyntax|Like patterns in the Find statement]].</p>
</td>
</td>
</tr>
</tr>  
</table>
</table>
===Syntax notes===
===Syntax notes===
<p>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.</p>
<ul>
<p>If COMPACT is specified with DISPLAY PROCEDURE LIST, <var class="product">Model&nbsp;204</var> lists the procedure names, separated by commas, across the output line. COMPACT overrides the HEADER and VERBOSE options.</p>
<li>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.</li>
<p>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.</p>
 
<p>The following examples apply to files created in Release 8.1 or later.</p>
<li>If <var>COMPACT</var> is specified with <code>DISPLAY PROCEDURE LIST</code>, <var class="product">Model&nbsp;204</var> lists the procedure names, separated by commas, across the output line. <var>COMPACT</var> overrides the <var>HEADER</var> and <var>VERBOSE</var> options.
<p>
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.</p></li>
</ul>


==Example==
==Example==
Line 91: Line 91:
SAVINGS.EXTRACT      04/02/88  08:44:10  7764 AC239
SAVINGS.EXTRACT      04/02/88  08:44:10  7764 AC239
</p>
</p>
<p>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: </p>
<p>
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: </p>
<p class="code">DISPLAY (BRIEF) LIST
<p class="code">DISPLAY (BRIEF) LIST
ACCT.REPORT
ACCT.REPORT
Line 97: Line 98:
MAIN.MENU SAVINGS.EXTRACT  
MAIN.MENU SAVINGS.EXTRACT  
</p>
</p>
==Usage notes==
==Usage notes==
<p>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.</p>
<ul>
<p><var class="product">Model&nbsp;204</var> 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.</p>
<li>This form of the <var>DISPLAY PROCEDURE</var> command displays the names of a user's procedures. The output of the <var>DISPLAY PROCEDURE</var> command is sorted by procedure name whenever <var>LIST</var> is specified.
<p>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).</p>
<p>
<p>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.</p>
<var class="product">Model&nbsp;204</var> 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.</p></li>
<p>The display format is as follows:</p>
 
<table>
<li>The <var>DISPLAY PROCEDURE LIST</var> command can be used to display information about procedures in a currently open file or group (assuming that the group has a PROCFILE).
 
<p>
<tr> <th>
The options <var>VERBOSE</var>, <var>BRIEF</var>, <var>HEADER</var>, and <var>NOHEADER</var> take effect when <var>LIST</var> is specified. The options enable you to choose the amount and form of the information to be displayed.</p>
<p>Information </p>
<p>
</th> <th>
The display format is as follows:</p>
<p>Appears in column...</p>
<table>
</th> </tr>
<tr class="head"> <th>Information </th>  
<th>Appears in column...</th> </tr>
    
    
<tr> <th><var>
<tr> <th><var>Procedure name</var></th>  
<p>Procedure name </p>
<td>1 through 29.  
</var></th> <td>
<p>
<p>1 through 29. </p>
If the procedure name exceeds 29 characters, the name continues in column 30 through the value of the <var>[[OUTCC parameter|OUTCCC]]</var> 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.</p>
<p>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.</p>
</td> </tr>
</td> </tr>
   
   
<tr> <th><var>
<tr> <th><var>Date of the last update </var></th>  
<p>Date of the last update </p>
<td>31 through 38.</td> </tr>
</var></th> <td>
<p>31 through 38.</p>
</td> </tr>
   
   
<tr> <th><var>
<tr> <th><var>Time of the last update</var></th>  
<p>Time of the last update </p>
<td>40 through 47.</td> </tr>
</var></th> <td>
<p>40 through 47.</p>
</td> </tr>
   
   
<tr> <th><var>
<tr> <th><var>Length of the procedure in bytes</var></th>  
<p>Length of the procedure in bytes </p>
<td>49 through 54.</td> </tr>
</var></th> <td>
<p>49 through 54. </p>
</td> </tr>
   
   
<tr> <th><var>
<tr> <th><var>ID of the last user to update</var></th>  
<p>ID of the last user to update </p>
<td>56 through 65.</td> </tr>
</var></th> <td>
<p>56 through 65.</p>
</td> </tr>
   
   
<tr> <th><var>
<tr> <th><var>Security class</var></th>  
<p>Security class </p>
<td>67 through 69. </td> </tr>
</var></th> <td>
<p>67 through 69. </p>
</td> </tr>
   
   
<tr> <th><var>
<tr> <th><var>Name of the file to which the procedure belongs (if in multiple-procedure-file group context</var>) </th>  
<p>Name of the file to which the procedure belongs, if in multiple-procedure-file group context </p>
<td>71 through 78.</td> </tr>  
</var></th> <td>
<p>71 through 78.</p>
</td> </tr>
 
</table>
</table>
<p>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.</p>
 
<p>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.</p>
<p>
<p>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.</p>
If the <var>ALIAS</var> 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.</p>
<p>The date, time, user ID, and length information for each procedure is stored in the procedure dictionary of the file that contains the procedure. <var class="product">Model&nbsp;204</var> initially stores this information in the file the first time the procedure is defined in the file. <var class="product">Model&nbsp;204</var> updates the procedure information each time the procedure is updated.</p>
<p>
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.</p>
<p>
The format is the default display format for both full screen and line-at-a-time terminals. If the <var>OUTCCC</var> parameter is set to a value less than 70, the display lines wrap to fit in the available display area.</p></li>
 
<li>The date, time, user ID, and length information for each procedure is stored in the procedure dictionary of the file that contains the procedure. <var class="product">Model&nbsp;204</var> initially stores this information in the file the first time the procedure is defined in the file. <var class="product">Model&nbsp;204</var> updates the procedure information each time the procedure is updated.</li>
</ul>
 
[[Category: General user commands]]
[[Category: General user commands]]
[[Category:Commands]]
[[Category:Commands]]

Revision as of 20:15, 15 April 2014

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 The 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 Any of the pattern matching options described in detail in Pattern matching. 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 the Find statement.

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.

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 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.