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

/SEQUENTIAL

/NOSEQUENTIAL (Default)

When a file is copied to or from a record oiriented device, the contents are always converted to sequential format, if necessary. When copied from and to a block oriented device, such as a disk, the default behaviour is to copy in block mode, which preserves any internal file organization. This qualifier can be used to force the contents to be converted to sequential format.

For some files, the format of the file is derived from the file type. For example, the file MYDATA.LOG-GZ is assumed to be a GZIPped log file. By default, the result of a copy will still be a GZIPped log file. Using the /SEQUENTIAL qualifier will effectively GUNZIP the file, converting it into a log file.

By default, /NOSEQUENTIAL is assumed.

Examples

$ DEVTOOLS COPY *ABC*.* *DEF*.*
      

Copies a file or a set of files to a target file in a specialised fashion.

Format

DEVTOOLS COPY/EXACT input-filespec output-filespec

Parameters

input-filespec

output-filespec

Qualifiers

/DUPLICATES (default)

/NODUPLICATES

When negated specifies that where multiple versions of a specific file name and type exist, only the first one found will be copied or appended to the output file(s). This is useful when the input file specification contains a search list or wildcarded directory. Specifying this (/NODUPLICATES) with wildcard versions results in only the latest versions being copied.

By default, /DUPLICATES is assumed which mimics the normal operation of the DCL COPY command.

/LOG

/NOLOG (default)

Controls whether the COPY command displays the file specifications of each file copied.

When you use the /LOG qualifier, the COPY command displays the following for each copy operation:

• The file specifications of the input and output files
• The number of blocks or the number of records copied (depending on whether the file is copied on a block-by-block or record-by- record basis)

/OVERLAY

/NOOVERLAY (default)

Examples

$ DEVTOOLS COPY FIN_LIB_DIR:*.MMS_INC FIN_LIBN_DIR:FIN_APPENDS.MMS
      

Defines a key to execute a command. This enables you to press a key to enter a command instead of typing the command name.

Format

DEVTOOLS DEFINE/KEY key-name "string"

Parameters

key-name

Specifies the name of the key you are defining. Use the following key names when defining keys:

Key Name	VT100	VT52	LK201
PF1	PF1	red key	PF1
PF2	PF2	blue key	PF2
PF3	PF3	black key	PF3
PF4	PF4	-	PF4
KP0, KP1-KP9	keypad 0-9	keypad 0-9	keypad 0-9
Period	period key	period key	period key
Comma	comma key	comma key	comma key
Minus	minus key	minus key	minus key
Enter	ENTER key	ENTER key	ENTER key
E1,E2	-	-	Find,Insert Here
E3,E4	-	-	Remove,Select
E5	-	-	Previous Screen
E6	-	-	Next Screen
Help,Do	-	-	Help(15), Do(16)
F17-F20	-	-	Function Keys

Note You cannot redefine the arrow keys or the function keys F1 to F14.

"string"

Specifies the string you want entered when you press the defined key. "String" can be a DEVTOOLS command, for example, DIRECTORY or SET FILE.

Qualifiers

/ECHO

/NOECHO

Specifies whether the command line is visible on the screen after you press the defined key. You cannot define a key specifying both the /NOECHO and /NOTERMINATE qualifiers. The default qualifier is /ECHO.

/IF_STATE=state_list

/NOIF_STATE

Specifies a list of states, any one of which must be set in order to enable the specified key definition. If you omit or negate this qualifier, the current state prevails.

States are used to increase the number of key definitions available on your terminal. The same key can be assigned any number of definitions as long as each definition is associated with a different state. State names can be any alphanumeric string.

/LOCK_STATE

/NOLOCK_STATE

Retains the state specified by the /SET_STATE qualifier until you use the /SET_STATE qualifier again to change it. The default qualifier is /NOLOCK_STATE.

States are used to increase the number of key definitions available on your terminal. The same key can be assigned any number of definitions as long as each definition is associated with a different state. State names can be any alphanumeric string.

/LOG

/NOLOG

Specifies whether informational messages are displayed. These messages signal successfully created key definitions. The default qualifier is /LOG.

/SET_STATE=state

/NOSET_STATE

Associates a state with the key you are defining. A state name can be any alphanumeric string. If you omit or negate this qualifier, the current state remains unchanged. You cannot define a key specifying both the /SET_STATE and /TERMINATE qualifiers.

States are used to increase the number of key definitions available on your terminal. The same key can be assigned any number of definitions as long as each definition is associated with a different state.

/TERMINATE

/NOTERMINATE (default)

Determines whether the specified command string executes when you press the key. When you use the /NOTERMINATE qualifier, you must press the Return key to execute the command string. You cannot define a key specifying both the /SET_STATE and /TERMINATE qualifiers.

Examples

DEVTOOLS> DEFINE/KEY PF1 "DIRECTORY"
      

This example shows how to define the keypad key PF1 as the DIRECTORY command. To enter the DIRECTORY command, press PF1 followed by the Return key.

DEVTOOLS> DEFINE/KEY KP6 "EDIT" /TERMINATE
      

This example shows how to define the keypad key 6 (KP6) as the EDIT command. The /TERMINATE qualifier causes the EDIT command to execute when you press KP6; you do not have to press the Return key.

DEVTOOLS> DEFINE/KEY PF2 "SET "/SET_STATE=ALTERED
DEVTOOLS> DEFINE/KEY PF3 "FILE" /IF_STATE=ALTERED /TERMINATE
      

In this example, the PF2 key is defined as the SET command, with the state name ALTERED. Then, the PF3 key is defined to output the string FILE when the state ALTERED is specified.

The /TERMINATE qualifier is used to end the command line. When you specify the /TERMINATE qualifier, you can avoid pressing the Return key to execute the command line. After you define PF2 and PF3, you can use them together. Press PF2 to produce the first half of the command line (SET) and press PF3 to finish the command line (FILE).

DEVTOOLS> DEFINE/KEY PF4 "SET " /SET_STATE=ALTERED
DEVTOOLS> DEFINE/KEY KP7 "FILE" /TERMINATE /IF_STATE=ALTERED
DEVTOOLS> DEFINE/KEY KP8 "FORWARD" /TERMINATE /IF_STATE=ALTERED
DEVTOOLS> DEFINE/KEY KP9 "WASTEBASKET" /TERMINATE /IF_STATE=ALTERED
      

This example shows how to define four different keys and associate them with a state named ALTERED:

1. The first definition defines the key PF4 as the SET command and associates this key with a state named ALTERED.
2. The second definition defines the keypad key 7 as "FILE" and makes it dependent on a state named ALTERED. When you press PF4 followed by keypad key 7, DEVTOOLS executes the SET FILE command.
3. The third definition defines keypad key 8 as "FORWARD" and also makes it dependent on the ALTERED state. When you press PF4 followed by keypad key 8, DEVTOOLS executes the SET FORWARD command.
4. The fourth definition defines keypad key 9 as "WASTEBASKET" and also makes it dependent on the ALTERED state. When you press PF4 followed by keypad key 9, DEVTOOLS executes the SET WASTEBASKET command.

Deletes one or more files. This command is similar to the DCL DELETE command with the addition of some extra qualifiers.

Format

DEVTOOLS DELETE filespec[,...]

Parameters

filespec[,...]

Specifies the names of one or more files to be deleted from a mass storage disk volume. The first file specification must contain an explicit or default directory specification plus an explicit file name, file type, and version number. Subsequent file specifications need contain only a version number; the defaults will come from the preceding specification. The asterisk (*) and the percent sign (%) wildcard characters can be used in any of the file specification fields.

If you omit the directory specification or device name, the current default device and directory are assumed.

If the file specification contains a null version number (a semicolon (;) followed by no file version number), a version number of 0, or one or more spaces in the version number, the latest version of the file is deleted.

To delete more than one file, separate the file specifications with either commas (,) or plus signs (+).

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.

/CONFIRM

/NOCONFIRM (default)

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

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

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

/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. This is the default action.
[NO]ERROR	Log errors.
[NO]NONE	Don't log any information. This is the equivalent to /NOLOG.
[NO]NOTFOUND	Log files that were not found.
[NO]SUCCESS	Log files that were deleted.

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

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

/SUBCONTEXT=(keyword=value,,,)

Specifies the various directories and libraries which will be checked for associated files to be deleted and the libraries which will be checked for modules to be deleted when a file is deleted 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 associated files and modules which will be deleted will include:

• NAME.*;* in the documentation directory;
• NAME*.*;* in the library directory;
• NAME.*;* in the software directory;
• NAME.TYPE;* in the work directory.
• NAME in the image library.
• NAME in the MMS library.
• NAME in the object library.
• NAME in the text library.

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 files and library modules associated when a file is deleted should also be deleted.

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

Examples

$ DEVTOOLS DELETE FIN_LIB_DIR:*.MMS_INC;*