See the OpenVMS DCL Concepts Manual for complete information on specifying time values.

/SUBCONTEXT=(keyword=value,...)

See the DEVTOOLS BEGIN SUBCONTEXT command for more details about the keywords and their values.

/SUFFIX=suffix

/NOSUFFIX (default)

By default, /NOSUFFIX is assumed.

/WORK=directory-code/NOWORK (default)

The following directory codes are available:

LIBRARY

Indicates that the library directory should be used in place of the work directory. Typically this would be used to generate MMS scripts for sources which have been generated in the library directory.

Description

The DEVTOOLS SCAN command generates a set of MMS and SQL scripts which can be used to build an application or a database. Each generated file has a file name of one of the following forms:

appl_list[suffix].MMS appl_list[suffix].SQL

where appl is the application code, list is one of the list names indicated below and suffix is optionally specified by the /SUFFIX qualifier.

Generated files which contain entries based on architecture dependent sources are created in the library directory. Those files which contain entries based on architecture independent sources are created in the architecure independent library directory.

Examples

$ DEVTOOLS SCAN *.*/CMS
      

Generates a list of target and inclusion scripts based on the set of sources in the current CMS library.

$ DEVTOOLS SCAN FIN_GEN_DIR:*.*/SUFFIX=_GEN
      

Generates a list of targets and inclusion scripts based on the set of sources in the FIN_GEN_DIR: directory. A suffix of _GEN is added to each of the name of each file generated.

Searches one or more files for the specified string or strings.

Format

DEVTOOLS SEARCH file-spec[,...] search-string[,...]

Parameters

file-spec

Specifies the names of one or more files to be searched. You must specify at least one file name. If you specify two or more file names, separate them with commas.

Wildcard characters are allowed in the file specification.

search-string

Specifies the character string to be located in the specified files. Enclose strings containing lowercase letters, blanks, or other nonalphanumeric characters (including spaces) in quotation marks.

You can use the /COMMENT, /EXACT and /SYMBOL qualifiers to alter the way that DEVTOOLS SEARCH matches search strings.

Qualifiers

/BACKUP

Modifies the time value specified with the /BEFORE or /SINCE qualifier. /BACKUP selects files according to the dates of their most recent backups. This qualifier is incompatible with the other qualifiers that also allow you to select files according to time attributes: /CREATED, /EXPIRED and /MODIFIED. If you specify none of these four time qualifiers, the default is /CREATED.

/BEFORE[=time]

Selects only those files dated prior to the specified time. You can specify time as an absolute time, as a combination of absolute and delta times, or as one of the following keywords: TODAY (default), TOMORROW, or YESTERDAY. Specify one of the following qualifiers with /BEFORE to indicate the time attribute to be used as the basis for selection: /BACKUP, /CREATED (default), /EXPIRED or /MODIFIED.

See the OpenVMS DCL Concepts Manual for complete information on specifying time values.

/BY_OWNER[=uic]

Selects only those files whose owner user identification code (UIC) matches the specified owner UIC. The default UIC is that of the current process.

Specify the UIC using standard UIC format as described in the OpenVMS DCL Concepts Manual.

/COMMENT (default)

/NOCOMMENT

Determines whether DEVTOOLS SEARCH matches strings in comments. A comment is defined as a line starting with one of the following:

! ; # * -- $! // '

Note that a dollar sign followed by white space and an exclamation mark is also consifered as a comment.

By default, strings are matched whether they are in a comment or not.

/CONFIRM

/NOCONFIRM (default)

Controls whether a request is issued before each search operation to confirm that the operation should be performed on that file. The following responses are valid:

YES NO QUIT TRUE FALSE [Ctrl/Z] 1 0 ALL [Return]

You can use any combination of uppercase and lowercase letters for word responses. Word responses can be abbreviated to one or more letters (for example, T, TR, or TRU for TRUE), but these abbreviations must be unique. Affirmative answers are YES, TRUE, and 1. Negative answers include: NO, FALSE, 0, and pressing the Return key. Entering QUIT or pressing Ctrl/Z indicates that you want to stop processing the command at that point. When you respond by entering ALL, the command continues to process, but no further prompts are given. If you type a response other than one of those in the list, DCL issues an error message and redisplays the prompt.

/CREATED

Modifies the time value specified with the /BEFORE or /SINCE qualifier. /CREATED selects files based on their dates of creation. This qualifier is incompatible with the other qualifiers that also allow you to select files according to time attributes: /BACKUP, /EXPIRED and /MODIFIED. If you specify none of these four time qualifiers, the default is /CREATED.

/EXACT

/NOEXACT (default)

Controls whether the DEVTOOLS SEARCH command matches the search string exactly or treats uppercase and lowercase letters as equivalents. By default, DEVTOOLS SEARCH ignores case differences in letters.

Specifying the /EXACT qualifier causes the system to use less CPU time. Therefore, if you are sure of the case of the letters in the string, it is more efficient to use /EXACT.

/EXCLUDE=(file-spec[,...])

Excludes the specified files from the search operation. You can include a directory but not a device in the file specification. Wildcard characters are allowed in the file specification. However, you cannot use relative version numbers to exclude a specific version. If you provide only one file specification, you can omit the parentheses.

/EXECUTE=command-filespec

/NOEXECUTE (default)

Determines whether DEVTOOLS SEARCH uses a TPU command file containing procedures and statements to perform changes to the selected files in addition to the standard search and replacment changes.

When the DEVTOOLS SEARCH command initializes, the TPU command file specified is read and compiled. After each selected file has had the standard search and replace actions, the compiled TPU command file statements are executed.

By default, no actions in addition to the standard search and replace are executed.

/EXPIRED

Modifies the time value specified with the /BEFORE or /SINCE qualifier. /EXPIRED selects files according to their expiration dates. (The expiration date is set with the SET SECURITY/EXPIRED command.) The /EXPIRED qualifier is incompatible with the other qualifiers that also allow you to select files according to time attributes: /BACKUP, /CREATED and /MODIFIED. If you specify none of these four time qualifiers, the default is /CREATED.

/LOG[=(option[,...]) (default)

/NOLOG

Outputs messages to the output file depending upon the option(s) specified.

The following log options are available:

Option	Meaning
[NO]ALL	Log all information.
[NO]CHECKED	Log each file that was searched.
NONE	Log no information (equivalent to /NOLOG).
[NO]FOUND	Log each file in which a search succeded.
[NO]SUMMARY	Produce a summary line indicating the number of files searched, the number of files with successful searches, and the number of successful searches.

/MODIFIED

Modifies the time value specified with the /BEFORE or /SINCE qualifier. /MODIFIED selects files according to the dates on which they were last modified. This qualifier is incompatible with the other qualifiers that also allow you to select files according to time attributes: /BACKUP, /CREATED and /EXPIRED. If you specify none of these four time modifiers, the default is /CREATED.

/OUTPUT[=output-file-spec]

/NOOUTPUT

Specifies the output file specification for the command.

By default, /OUTPUT=SYS$OUTPUT is assumed. The /NOOUTPUT qualifier means that no output will be produced by the command.

/SELECT=(keyword[,...])

Allows you to select files based on a number of criteria. Choose one of the following keywords:

ACL NOACL	Selects files that have an associated ACL or files that do not (NOACL keyword).
ATTRIBUTES=(option[,...])	Selects files which have particular attributes. The following options are supported: Option Description [NO]BACKUP Selects files which have backups enabled (BACKUP) or disabled (NOBACKUP) LRL=MAXIMUM=size Selects files which have a longest record size less than or equal to the specified value. LRL=MINIMUM=size Selects files which have a longest record size greater than or equal to the specified value. ORG=type Selects files which have the specified organization. Valid organizations include: DIRECT INDEXED RELATIVE SEQUENTIAL RFM=type Selects files which have the specified record format. Valid record formats include: STREAM STREAMCR STREAMLF UNDEFINED VARIABLE VFC
FILE=(option[,...])	Selects portions of the file specification for display purposes. The /SELECT=FILE qualifier is used to turn off specific portions by explicit or implicit specification of the options. Possible options are: [NO]NODE [NO]DEVICE [NO]DIRECTORY [NO]NAME [NO]TYPE [NO]VERSION /SELECT=FILE qualifier cannot be used with the /FULL qualifier.
ONLINE NOONLINE	Selects files that are online or shelved.
PRESHELVED NOPRESHELVED	Selects files that are preshelved or not preshelved.
SHELVABLE NOSHELVABLE	Selects files that are shelvable or not shelvable.
SIZE=(option[,...])	Selects files according to their size. Possible options are: Option Description MAXIMUM=n Selects files that have fewer blocks than the value of n, which defaults to 1,073,741,823. Use with MINIMUM=n to specify a size range for files to be selected. MINIMUM=n Selects files that have blocks equal to or greater than the value of n. Use with MAXIMUM=n to specify a size range for files to be selected. (MINIMUM=n, MAXIMUM=n) Selects files whose block size falls within the specified MINIMUM and MAXIMUM range.

/SINCE=[time]

Selects only those files dated after the specified time. You can specify time as an absolute time, a combination of absolute and delta times, or as one of the following keywords: TODAY (default), TOMORROW, or YESTERDAY. Specify one of the following qualifiers with /BEFORE to indicate the time attribute to be used as the basis for selection: /BACKUP, /CREATED (default), /EXPIRED or /MODIFIED.

See the OpenVMS DCL Concepts Manual for complete information on specifying time values.

/PREFIX

/NOPREFIX (default)

Controls whether the DEVTOOLS SEARCH command interprets the search strings as symbol prefaces rather than simple text. If /PREFIX is specified, the search strings only match when the values inside the source files have non symbol constituent characters before the search string. This feature is useful when it is necessary to search for an explicit word prefix which may exist as a sub-string within other words.

The /PREFIX qualifier cannot be used in conjunction with the /SUFFIX and /SYMBOL qualifiers.

By default, search strings are interpreted as simple text.

/SUFFIX

/NOSUFFIX (default)

Controls whether the DEVTOOLS SEARCH command interprets the search strings as symbol suffices rather than simple text. If /SUFFIX is specified, the search strings only match when the values inside the source files have non symbol constituent characters after the search string. This feature is useful when it is necessary to search for an explicit word suffix which may exist as a sub-string within other words.

The /SUFFIX qualifier cannot be used in conjunction with the /PREFIX and /SYMBOL qualifiers.

By default, search strings are interpreted as simple text.

/SYMBOL

/NOSYMBOL (default)

Controls whether the DEVTOOLS SEARCH command interprets the search strings as symbol names rather than simple text. If /SYMBOL is specified, the search strings only match when the values inside the source files have non symbol constituent characters before and after the search string. This feature is useful when it is necessary to search for an explicit word which may exist as a sub-string within other words.

The /SYMBOL qualifier cannot be used in conjunction with the /PREFIX and /SUFFIX qualifiers.

By default, search strings are interpreted as simple text.

/WILDCARDS=option

/NOWILDCARDS (default)

Indicates whether the search-string parameter values contain wildcards, and if so to what convention the wildcards conform.

The following wildcards conventions are available:

• ULTRIX
• VMS

See the OpenVMS EVE reference manual (SET WILDCARD ULTRIX and SET WILDCARD VMS) for complete information on wildcard searches.

By default the search-strings are assumed to contain no wildcard characters.

Examples

$ DEVTOOLS SEARCH CABLE.MEM,JOYNER.MEM "Manual Title"
      

This command searches the files CABLE.MEM and JOYNER.MEM for occurrences of the character string 'Manual Title'. It is necessary to enclose the strings in quotation marks because it contains a space character.

Lists the current context.

Format

DEVTOOLS SHOW CONTEXT

Qualifiers

/BRIEF

Specifies that the output listing is to include only the minimal context details.

/FULL

Specifies that the output listing is to include all context details.

/OUTPUT[=output-file-spec]

/NOOUTPUT

Specifies the output file specification for the command.

By default, /OUTPUT=SYS$OUTPUT is assumed. The /NOOUTPUT qualifier means that no output will be produced by the command.

/SUBCONTEXT

Specifies that the output listing is to include the subcontext details.

Examples

$ DEVTOOLS SHOW CONTEXT/FULL
 
  Your current context is: 
    Application DIST in DEV environment 
     + Application FIN in DEV environment 
    Scope is COMMON 
    Build default qualifiers are: /BATCH/COMBINED/MACHINE 
    Build memory qualifiers are: /FETCH
      

Lists the current subcontext.

Format

DEVTOOLS SHOW SUBCONTEXT

Qualifiers

/OUTPUT[=output-file-spec]

/NOOUTPUT

Specifies the output file specification for the command.

By default, /OUTPUT=SYS$OUTPUT is assumed. The /NOOUTPUT qualifier means that no output will be produced by the command.

Examples

$ DEVTOOLS SHOW SUBCONTEXT
 
  Dir. Code  Definition        Value 
  ---------  ----------        ----- 
     AIL     FIN_AIL_DIR:      DISK_DEV3:[FIN.LIB] 
     DOC     FIN_DOC_DIR:      DISK_DEV3:[FIN.DOC] 
     GEN     FIN_AIL_DIR:      DISK_DEV3:[FIN.LIB] 
     LIB     FIN_LIB_DIR:      DISK_DEV3:[FIN.LIB-ALPHA] 
     SFT     FIN_SFT_DIR:      DISK_DEV3:[FIN.SFT-ALPHA] 
     TST     FIN_TST_DIR:      DISK_DEV3:[FIN.TST-ALPHA] 
     WRK     FIN_WRK_DIR:      DISK_DEV3:[FIN.WRK]
 
      

Display the DEVTOOLS utility version.

Format

DEVTOOLS SHOW VERSION

Examples

$ DEVTOOLS SHOW VERSION
  SysWorks Version V3.4
      

Creates a subprocess of the current process. The context of the subprocess is copied from the current process. You can use the SPAWN command to leave the DEVTOOLS utility temporarily, perform other functions (such as displaying a directory listing or printing a file), and then return to DEVTOOLS.

Note that this command is only available for users with DCL access.

Format

DEVTOOLS SPAWN [command]

Parameters

command

Specifies the DCL command string that executes in the context of the created subprocess. When the command completes, the subprocess terminates and control is returned to the parent process. If this parameter is not specified, a subprocess is created that transfers control to DCL command level.

Qualifiers

/INPUT=file-spec

Specifies an input file containing one or more DCL command strings to be executed by the spawned subprocess. If you specify a command string along with an input file, the command string is processed before the commands in the input file. Once processing is complete, the subprocess is terminated.

/LOGICAL_NAMES

/NOLOGICAL_NAMES

Specifies that the logical names of the parent process are to be copied to the subprocess. When you do not want the subprocess to use the logical names of the parent process, enter the qualifier /NOLOGICAL_NAMES. The default is /LOGICAL_NAMES.

/OUTPUT=file-spec

Identifies the output file to which the results of the SPAWN operation are written. Whenever you use the /NOWAIT qualifier, you should also use the /OUTPUT qualifier to specify a new output destination. Doing so prevents output from being displayed while you are specifying new commands. If you omit the /OUTPUT qualifier, output is written by default to the current SYS$OUTPUT device.

/PROCESS=subprocess-name

Specifies the name of the subprocess to be created. The default name of the subprocess is USERNAME_n. If the subprocess name contains spaces or special characters, or is case-sensitive, then the subprocess name must be enclosed in quotation marks.

/SYMBOLS

/NOSYMBOLS

Determines whether the system passes DCL global and local symbols to the subprocess. The default is /SYMBOLS.

/WAIT/NOWAIT

Controls whether the system waits until the subprocess is completed before allowing more commands to be specified. The /NOWAIT qualifier allows you to specify new commands while the specified subprocess is running. If you specify /NOWAIT, you should also use the /OUTPUT qualifier to direct the output stream to a file, rather than displaying it on your terminal. Doing so prevents your terminal from being used by more than one process simultaneously.

Examples

DEVTOOLS> SPAWN SHOW TIME
      

This example shows how to create a subprocess that executes the DCL command SHOW TIME while you are using DEVTOOLS utility.

DEVTOOLS> SPAWN /NOLOGICAL_NAMES SET HOST
_Node: MARS 
   .
   .
   .
$ LOGOUT
CRAMMER logged out at ... 
 
%REM-S-END, control returned to node _BETA:: 
 
DEVTOOLS>
      

This example shows how to use the SPAWN command to create a subprocess in which you SET HOST to another node. When you want to leave node MARS and move back to node BETA, enter the DCL command LOGOUT. The /NOLOGICAL_NAMES qualifier prevents the logical names of the parent process from being copied to the subprocess.