SysWorks©

SysWorks
Command Reference Manual
Previous Contents Index

By default, /NOINITIALIZE_HANDLES is assumed.

/INTERACTIVE

Specifies that the BUILD command should be performed in the context of an interactive process.

Use of the /INTERACTIVE qualifier is incompatible with /BATCH, /DETACHED and /SUBPROCESS. /SUBPROCESS is the default.

/KEEP (Default)

/NOKEEP

Specifies that a /KEEP qualifier to be applied when submitting the BUILD command to batch.

Use of the /KEEP qualifier is compatable only with the /BATCH qualifier.

/KEPT[=(utility[,...])] (Default)

/NOKEPT

Specifies that certain utilities should use kept subprocesses. This feature is particularly useful for CDO where activation time can be significantly longer that taken to define a simple object such as a field.

A NO can prefix a utility name which indicates that utility is not to use a kept subprocess. This is useful for ADU where task group builds in a kept subprocess may hold on to virtual memory after the build has completed.

The list established with /KEPT is accumulative. The initial and default list is /KEPT=(ADU,CDO,RDU). For example, using /KEPT=NOADU results in the same effect as /KEPT=(CDO,RDU).

/KITBLD

Specifies that if an application kit directory (i.e appl_KIT_DIR or DISK_env:[appl.KIT]) is present, an installation kit should be built for the application.

/LIST (Default)

/NOLIST

Specifies whether targets should be built and sources compiled with the /LIST qualifier applied.

Note that unlike other typical compiler commands, the BUILD /LIST qualifier cannot take a list file specification. All listings are forced into the library directory.

By default, /LIST is assumed.

/LOG[=log-file] (Default)

/NOLOG

Specifies whether to produce a log file of the BUILD command execution and optionally its file specification.

By default, /LOG=SYS$DISK:[]BUILD.LOG is assumed.

/MACHINE_CODE

/NOMACHINE_CODE (Default)

Specifies whether sources should be compiled with the /MACHINE_CODE qualifier applied.

By default, /NOMACHINE_CODE is assumed.

/MAP (Default)

/NOMAP

Specifies whether targets should be built with the /MAP qualifier applied.

Note that unlike other typical linker commands, the BUILD /MAP qualifier cannot take a map file specification. All maps are forced into the library directory.

By default, /MAP is assumed.

/MEMBER_ALIGNMENT (Default)

/NOMEMBER_ALIGNMENT

Specifies whether sources should be compiled with the /MEMBER_ALIGNMENT qualifier applied. This qualifier applies only to OpenVMS Alpha.

By default, /MEMBER_ALIGNMENT is assumed.

/MEMORY

/NOMEMORY

Specifies that the qualifiers used with the previous BUILD command should be used at this point.

If no qualifiers are present /MEMORY is assumed by default, otherwise /NOMEMORY is the default.

/NAME=job-name

Specifies that a /NAME qualifier to be applied when submitting the BUILD command to batch.

Use of the /NAME qualifier is compatable only with the /BATCH qualifier.

By default, /NAME=BUILD is assumed with the /BATCH qualifier.

/NATIVE_ONLY (Default)

/NONATIVE_ONLY

For Alpha linking, prevents the linker from passing along procedure signature block (PSB) information in special fix-ups to the image activator. The image activator uses this information to build jackets so that native OpenVMS Alpha images can call translated OpenVMS VAX images. Note that this qualifier does not prevent incoming calls from translated OpenVMS VAX images.

/NODE[=node-name]

Specifies that the action specified with the /SAVE or /UNSAVE qualifier be performed on a node specific save file. If no node name is specified, the name of the current node is assumed.

By default, /NODE is assumed.

/NOTIFY

/NONOTIFY

Specifies that a /NOTIFY qualifier to be applied when submitting the BUILD command to batch.

Use of the /NOTIFY qualifier is compatable only with the /BATCH qualifier.

/OPTIMIZE (Default)

/NOOPTIMIZE

Specifies whether targets will be built and sources compiled with the /OPTIMIZE qualifier applied.

If /DEBUG is not specified or /NODEBUG is specified, /OPTIMIZE is assumed by default.

If /DEBUG is specified and no /OPTIMIZE or /NOOPTIMIZE qualifier is specified, /NOOPTIMIZE is applied by default.

/PHASES=(phase[,...])

Specifies which phases of the build are to be executed. If /PHASES=ALL is used, it is equivalent to: 


/PHASES=(SETUP,GENERATE,SCAN,RULES,DESCRIP)

This set of default phases can be controlled using the SWDEV_BUILD_PHASES logical name, the equivalence of which is a comma separated list of the phases.

If /FETCH is specified, /PHASES=ALL is assumed. If /UPDATE is specified without /FETCH, /PHASES=NONE is assumed. If neither of these qualifiers are present, /PHASES=DESCRIP is assumed.

/PRINT

/NOPRINT (Default)

Specifies that a /PRINT qualifier to be applied when submitting the BUILD command to batch.

Use of the /PRINT qualifier is compatable only with the /BATCH qualifier.

/QUEUE=batch-queue-name

Specifies the name of the batch queue into which the BUILD command should be placed for execution.

By default, /QUEUE=SYS$BATCH is assumed with the /BATCH qualifier.

Use of the /QUEUE qualifier is compatable only with the /BATCH qualifier.

/RELATED[=(appl[,...])

/NORELATED (Default)

Specifies related applications which should also be built. These extra builds are executed before the KITBLD phase.

If /RELATED is specified without a value, the related applications specified by the CONTEXT/ADD command are used by default. These are typically set up in an application's ENTER.COM command procedure.

By default, /NORELATED is assumed.

/RULES=mms-script-file

Specifies an alternative MMS rules script.

By default, MMS$RULES is used.

/SAVE

Specifies that the qualifiers specified with the BUILD command (including any applied with an explicit /MEMORY qualifier) should be saved as the default BUILD command qualifiers.

Unless the /EXECUTE qualifier is explicitly applied, the BUILD command is not executed.

The /SAVE qualifier itself is not saved in the BUILD command's default or previous qualifiers.

/SCA_LIBRARY

/NOSCA_LIBRARY (Default)

Specifies that products that support SCA, will also update the SCA library after a successful build or compilation.

By default, /NOSCA_LIBRARY is assumed.

/SCOPE={COMMON|SPECIFIC|sub-directory}

Specifies the scope to be established for the BUILD command, independent of the current or default scope for this application environment.

This qualifier is incompatible with the /COMMON and /SPECIFIC qualifiers which also specify the scope under which the BUILD should be executed.

/SPECIFIC

Specifies that the specific scope is to be established for the BUILD command, independent of the current or default scope for this application environment.

This qualifier is incompatible with the /COMMON and /SCOPE qualifiers which also specify the scope under which the BUILD should be executed.

/STATISTICS

/NOSTATISTICS (Default)

Specifies that a report about process statistics should be produced at the end of the BUILD job.

By default, /NOSTATISTICS is assumed.

/SUBPROCESS (Default)

Specifies that the BUILD command should be performed in the context of a sub-process of the current process.

Use of the /SUBPROCESS qualifier is incompatible with /BATCH, /DETACHED and /INTERACTIVE.

/SYNCHRONIZE=job-entry

Specifies that a SYNCHRONIZE command is to be used in the BUILD job before the BUILD command is executed, in order to wait until another batch job has finished.

Use of the /SYNCHRONIZE qualifier is compatable only with the /BATCH qualifier.

/TIDY

Specifies that if the build is occuring in the common scope, any specific scope files in the developers specific library directory should be deleted. This is achieved by passing the introducing an extra TIDY phase before the FETCH phase.

/TRACEBACK (Default)

/NOTRACEBACK

Directs the linker to include traceback information in the image file. If you specify the /DEBUG qualifier, the linker includes traceback information by default, overriding the /NOTRACEBACK qualifier if it is specified.

/UPDATE

/NOUPDATE (Default)

Specifies whether sources should be updated into the work directory before the BUILD command is executed.

By default, /NOUPDATE is assumed.

/USERLIBRARY (Default)

/NOUSERLIBRARY

Specifies a qualifier which the BUILD command applies to any LINK commands issued.

By default, the /USERLIBRARY qualifier is applied.

/USERNAME=vms-username

Specifies that a /USERNAME qualifier to be applied when submitting the BUILD command to batch.

Use of the /USERNAME qualifier is compatable only with the /BATCH qualifier.

/VERIFY

/NOVERIFY (Default)

Specifies whether the BUILD command is verified (i.e. displayed in the output stream) before it is executed.

By default, the command is not verified.

/WARNINGS

/NOWARNINGS (Default)

Specifies whether compilers invoked by the BUILD command should print warning or informational messages as well as error and severe error messages.

Examples

#1 

$ BUILD/BATCH/UPDATE/FETCH

CHANGE

Searches one or more files for the specified string or strings and replaces the occurrences with the specified replacement string.

Format

CHANGE file-spec[,...] search-string[,...] replace-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 CHANGE matches search strings.

replace-string

Specifies the character string to be substituted when search-strings are found. Enclose strings containing lowercase letters, blanks, or other nonalphanumeric characters (including spaces) in quotation marks.

Each value in the replace-string parameter list is substituted for the corresponding value in the search-string parameter list. When there are fewer values in the replace-string list, the last value is used for the remaining search-string values. When there are more values in the replace-string parameter list, the excess values are ignored.

You can use the /CASE_ADAPTION qualifier to alter the way that CHANGE replaces matched 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.

/CASE_ADAPTION

/NOCASE_ADAPTION (default)

Controls whether the CHANGE command inserts the replacement string exactly as specified or changes its case to suit the matched search string.

If case adaption is specified, the case of the first character in the replacement string is made the same as the first character in the found text and the case of the remaining replacement characters is made the same as the second character of the found text.

By default, no case adaption occurs.

/COMMENT (default)

/NOCOMMENT

Determines whether CHANGE 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 change 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 CHANGE command matches the search string exactly or treats uppercase and lowercase letters as equivalents. By default, CHANGE 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 change 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 CHANGE 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 CHANGE 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]CHANGED Log each file that was changed.
[NO]CHECKED Log each file that was searched.
NONE Log no information (equivalent to /NOLOG).
[NO]SUBSTITUTIONS Log each substitution made in changed files.
[NO]SUMMARY Produce a summary line indicating the number of files searched, the number of files changed, and the number of changes made.
[NO]UNCHANGED Log each file that was not changed.

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

/VERIFY

/NOVERIFY (default)

Controls whether the CHANGE command displays lines containing replacement strings. By default, lines containing replacements are not displayed.

/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:

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

#1 

$ CHANGE CABLE.MEM,JOYNER.MEM "MANUAL TITLE" "Manual Title"

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

Previous Next Contents Index