SysWorks©

SysWorks
Command Reference Manual
Previous Contents Index

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

/PREFIX

/NOPREFIX (default)

Controls whether the DEVTOOLS 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 DEVTOOLS 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 DEVTOOLS 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 DEVTOOLS 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 

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

DEVTOOLS CHANGE/OBJECT

Changes object files in order to remove unnecessary error messages during a build.

Format

DEVTOOLS CHANGE/OBJECT file-spec[,...]

Parameters

file-spec

Specifies the names of one or more files to be changed. 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.

Qualifiers

/LOG (default)

/NOLOG

Controls whether the DEVTOOLS CHANGE/OBJECT command displays the file specification of each file after it has been changed.

/REMOVE[=item[,...]]

Specifies which items should be removed from an object file. At this time the only valid item is WARNINGS which indicates that modules which have a warning status should have that status reset to success.

Examples

#1 

$ DEVTOOLS CHANGE/OBJECT FIN_LIB_DIR:*.OBJ

This command removes all warnings from the object files in the FIN application library directory.

DEVTOOLS CHGCTL

Invokes the change control menu. See CHGCTL for details.

DEVTOOLS CMS

Perform a CMS command.

This section provides information about each of the subcommands you can use with the DEVTOOLS CMS command.

DEVTOOLS CMS COPY ELEMENT

Copies a CMS library element to a new element name or another library.

Format

DEVTOOLS CMS COPY ELEMENT old-element-expression new-element-name "remark"

Parameters

old-element-expression

Specifies one or more existing elements to be copied. If you specify more than one element to be copied, you must use a wildcard character for the new element name. An old element expression can be an element name, a group name, a wildcard expression, or a list of these separated by commas.

new-element-name

Specifies the name for the new element. The name cannot be the same as any existing element name in the target library. The file name component cannot be 00CMS because this name is reserved for CMS. Wildcards are allowed. If you specify more than one element with COPY ELEMENT, you must use a wildcard character for the new element name.

remark

Specifies a CMS remark. See CMS HELP COPY ELEMENT for more details.

DEVTOOLS CMS CREATE ELEMENT

Creates a CMS library element.

If the logical name appl_CMS_PATH is defined (where appl is the code of the user's current application), the created generation of the element is also inserted into the first class specified by its equivalence.

If the logical name appl_CMS_VARIANT is defined (where appl is the code of the user's current application), a variant generation of the element is created in addition to the first generation. The variant letter is specified by the logical names equivalence. Note that if the appl_CMS_PATH logical is also used, it will be the variant generation that will be inserted into the specified class.

Format

DEVTOOLS CMS CREATE ELEMENT new-element-name "remark"

Parameters

new-element-name

remark

Specifies a CMS remark. See CMS HELP CREATE ELEMENT for more details.

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.

/BINARY

/NOBINARY (Default)

Specifies whether binary file types are forced to have standard binary file attributes during the DEVTOOLS CMS element creation operation. The standard binary file attributes are the equivalent to those set by the command DEVTOOLS SET FILE/ATTRIBUTES=(RFM=FIX,LRL=512,RAT=NONE).

By default, file attributes are not forced to the standard binary file attributes.

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

/CLASS=class-name

Specifies that the created generation of the element will be inserted into the specified class.

If you omit /CLASS and /PATH and there is no appl_CMS_PATH logical name defined, DEVTOOLS CMS CREATE ELEMENT doesn't insert any generation of the element into any class.

This qualifier overrides the action of the appl_CMS_PATH logical name.

This qualifier is incompatible with the /PATH qualifier.

/CONFIRM

/NOCONFIRM (default)

Controls whether a request is issued before each CMS element creation 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.

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

Excludes the specified files from the CMS element creation 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.

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

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

/PATH[=(generation-expression[,...])]

Specifies that the created generation of the element will be inserted into the first class found in the generation expression search list.

If you omit /CLASS and /PATH and there is no appl_CMS_PATH logical name defined, DEVTOOLS CMS CREATE ELEMENT doesn't insert any generation of the element into any class.

This qualifier overrides the action of the appl_CMS_PATH logical name.

This qualifier is incompatible with the /CLASS qualifier.

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

DEVTOOLS CMS DELETE ELEMENT

Deletes a CMS library element.

If the logical name appl_CMS_PATH is defined (where appl is the code of the user's current application), any generations of the element currently inserted in the classes specified by the equivalence of the logical name will be removed from them rather than being actually deleted.

Format

DEVTOOLS CMS DELETE ELEMENT old-element-name "remark"

Parameters

old-element-name

remark

Specifies a CMS remark. See CMS HELP DELETE ELEMENT for more details.

Qualifiers

/COMBINED

/NOCOMBINED (default)

Specifies in conjunction with the /TIDY qualifier that directories and libraries associated with both architectures will be checked for files and modules to be deleted. See the /TIDY qualifier for more details.

/CONTEXT=(keyword=value,,,)

Specifies the context in which the command should execute.

By default the current context is assumed.

See the UTLTOOLS FETCH SUBCONTEXT command for more details about the keywords and their values.

/CLASS=class-name

Specifies that a generation of the element will be removed from the specified class rather than the elemnet being deleted from the library.

If you omit /CLASS and /PATH and there is no appl_CMS_PATH logical name defined, DEVTOOLS CMS DELETE ELEMENT deletes the element rather than removing it from any class.

This qualifier overrides the action of the appl_CMS_PATH logical name.

This qualifier is incompatible with the /PATH qualifier.

/PATH[=(generation-expression[,...])]

Specifies that first generation of the element found in the generation expression search list will be removed from its class rather than the element being deleted from the library.

If you omit /CLASS and /PATH and there is no appl_CMS_PATH logical name defined, DEVTOOLS CMS DELETE ELEMENT deletes the element rather than removing it from any class.

This qualifier overrides the action of the appl_CMS_PATH logical name.

This qualifier is incompatible with the /CLASS qualifier.

/SUBCONTEXT=(keyword=value,,,)

Specifies the various directories and libraries which will be checked for intermediate files to be deleted and the libraries which will be checked for modules to be deleted when an element is deleted from the CMS library or a generation is removed from a CMS class and the /TIDY qualifier (which must also be specified) is used.

For an element with a name and type of the form NAME.TYPE, the intermediate files and modules which will be deleted will include:

By default the directories and libraries are those associated with the application.

See the UTLTOOLS FETCH SUBCONTEXT command for more details about the keywords and their values.

/TIDY

/NOTIDY (default)

Specifies that intermediate files and library modules associated when an element is deleted from the CMS library or a generation is removed from a CMS class should be deleted.

See the /SUBCONTEXT qualifier for details about how to specify which directories will be searched for intermediate files.

DEVTOOLS CMS FETCH

Fetches a CMS library generation.

Format

DEVTOOLS CMS FETCH old-element-name "remark"

Parameters

old-element-name

remark

Specifies a CMS remark. See CMS HELP FETCH for more details.

Qualifiers

/COMBINED

/NOCOMBINED (default)

Specifies in conjunction with the /TIDY qualifier that directories and libraries associated with both architectures will be checked for files and modules to be deleted. See the /TIDY qualifier for more details.

/CONTEXT=(keyword=value,,,)

Specifies the context in which the command should execute.

By default the current context is assumed.

See the UTLTOOLS FETCH SUBCONTEXT command for more details about the keywords and their values.

/GENERATION[=generation-expression]

Specifies a particular generation of the element that is to be fetched.

If you omit /GENERATION and /PATH and there is no appl_CMS_PATH logical name defined, DEVTOOLS CMS FETCH fetches the most recent generation on the main line of descent.

This qualifier overrides the action of the appl_CMS_PATH logical name.

This qualifier is incompatible with the /PATH qualifier.

/OUTPUT[=file-specification]

Directs DEVTOOLS CMS FETCH to write output to the specified file. If you omit the /OUTPUT qualifier (or if you specify /OUTPUT but do not provide a file specification), DEVTOOLS CMS FETCH creates a file with the same name as the element.

If you fetch more than one element (by specifying wildcards or a group name for the element expression parameter), and you do not specify wildcards in the output file specification, DEVTOOLS CMS FETCH creates successive versions of the file indicated by /OUTPUT.

/PATH[=(generation-expression[,...])]

Specifies that the first generation found in the generation expression search list of the element should be fetched.

If you omit /GENERATION and /PATH and there is no appl_CMS_PATH logical name defined, DEVTOOLS CMS FETCH fetches the most recent generation on the main line of descent.

This qualifier overrides the action of the appl_CMS_PATH logical name.

This qualifier is incompatible with the /GENERATION qualifier.

/SUBCONTEXT=(keyword=value,,,)

Specifies the various directories and libraries which will be checked for intermediate files to be deleted and the libraries which will be checked for modules to be deleted when a generation is fetched from the CMS library and the /TIDY qualifier (which must also be specified) is used.

For an element with a name and type of the form NAME.TYPE, the intermediate files and modules which will be deleted will include:

By default the directories and libraries are those associated with the application.

See the UTLTOOLS FETCH SUBCONTEXT command for more details about the keywords and their values.

/TIDY

/NOTIDY (default)

Specifies that intermediate files and library modules associated when a generation is fetched from the CMS library should be deleted.

See the /SUBCONTEXT qualifier for details about how to specify which directories will be searched for intermediate files.

Previous Next Contents Index