SysWorks©

SysWorks
Command Reference Manual


Previous Contents Index


DEVTOOLS DELETE/REVERSE

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

Format

DEVTOOLS DELETE/REVERSE filespec[,...]


Parameters

filespec[,...]


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.

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


Examples

#1

$ DEVTOOLS DELETE/REVERSE FIN_LIB_DIR:*.*;*
      


DEVTOOLS DIFFERENCES/DATES

Compare the revision dates of two sets of objects and generate a DCL command procedure to update one or both sets. Currently the sets of objects include files and CMS elements or generations. The update procedure uses BACKUP and/or CMS commands so that the modification date of the files or generations are not changed.

Format

DEVTOOLS DIFFERENCES/DATES new-dir old-dir


Parameters

new-dir

Specifies the directory and optional file or element specification for the directory or CMS library which contains the newer versions of the files or generations. Files or generations which are new or newer in this directory will be duplicated in the area specified by the old-dir parameter.

old-dir

Specifies the directory and optional file or element specification for the directory or CMS library which contains the older versions of the files or generations. Files or generations which are older in this directory will be updated from the area specified by the new-dir parameter. Those which do not exist in the new-dir area will be deleted or removed.

Qualifiers

/BOTH

/NOBOTH (default)

Specifies that both sets of objects should be updated. The result is that both sets of objects contain the union of the latest files or generations.

By default, /NOBOTH is assumed which results in only the old-dir object set being updated.

/CMS

/NOCMS (default)

Specifies that the parameter to which this qualifier is applied is a CMS library rather than a file directory.

By default, a file directory is assumed.

This qualifier is incompatible with the /LIBRARY qualifier.

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

/COMMENT="CMS comment"

Specifies a comment to be used with CMS commands in the generated script. By default /COMMENT="Builder/VMS" is assumed.

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

/DELETE (default)

/NODELETE

Specifies whether files or generations found in the old-dir area but not in the new-dir area should be deleted or removed.

By default, the deletion or removal of these files or generations is assumed.

/EXECUTE

/NOEXECUTE (default)

Specifies whether DEVTOOLS DIFFERENCES/DATE executes the commands which it generates immediately.

By default, command are not executed immediatly.

The /EXECUTE and /OUTPUT qualifiers are notionally opposites, which is also true of their defaults. However, combining them together both executes the commands immediatly and creates an output file of the commands. Using both with their negated forms results causes the comparisons to be made, but no actions executed and no file of actions to execute being generated.

/GENERATION[=generation-expression]

Specifies that the generation of each element found in the generation expression rather than all elements should for the set of objects being considered.

This qualifier is used only in conjunction with the /CMS qualifier.

If you omit /CLASS and /PATH and there is no appl_CMS_PATH logical name defined, DEVTOOLS DIFFERENCES/DATES uses the latest generation in the mainline for consideration.

This qualifier overrides the action of the appl_CMS_PATH logical name.

This qualifier is incompatible with the /PATH qualifier.

/LIBRARY

/NOLIBRARY (default)

Specifies that the parameter to which this qualifier is applied is an OpenVMS library file rather than a file directory.

By default, a file directory is assumed.

This qualifier is incompatible with the /CMS qualifier.

/LOG (Default)

/NOLOG

Specifies whether commands should log results when executed. This is the equivalence of adding /LOG to the underlying commands eg. BACKUP/LOG, CMS .../LOG or DELETE/LOG.

By default, the commands log their results.

/MERGE

/NOMERGE (default)

/OPTIMIZE (default)

/NOOPTIMIZE

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

The /EXECUTE and /OUTPUT qualifiers are notionally opposites, which is also true of their defaults. However, combining them together both executes the commands immediatly and creates an output file of the commands. Using both with their negated forms results causes the comparisons to be made, but no actions executed and no file of actions to execute being generated.

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

Specifies that the first generation of each element found in the generation expression search list rather than all elements should for the set of objects being considered.

This qualifier is used only in conjunction with the /CMS qualifier.

If you omit /CLASS and /PATH and there is no appl_CMS_PATH logical name defined, DEVTOOLS DIFFERENCES/DATES uses the latest generation in the mainline for consideration.

This qualifier overrides the action of the appl_CMS_PATH logical name.

This qualifier is incompatible with the /GENERATION qualifier.

/SINCE=[time]

Selects only those object dated after the specified time for consideration. 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.

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 intermediate files to be deleted and the libraries which will be checked for modules to be deleted when a file, element or generation is deleted or removed from a directory or 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 file, element or generation is deleted or removed from a directory or CMS library should also be deleted.

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

/VARIANT=variant-letter

Specifies that generations are to be created in a variant stream with the indicated variant letter.

By default, the logical name appl_CMS_VARIANT controls this action.


DEVTOOLS DIFFERENCES/RDB_DATABASE


Format

DEVTOOLS DIFFERENCES/RDB_DATABASE new-rdb-database old-rdb-database


Parameters

new-rdb-database

old-rdb-database


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.


DEVTOOLS DO

Executes a DCL command (including the "@" command) in a context other than the current process.

Format

DEVTOOLS DO/qualifiers] [dcl-command]


Convenience Commands

NETTERM

Creates a terminal window on specified nodes. This command is equivalent to


      DEVTOOLS DO/INTERACTIVE/TERMINAL/WINDOW/REMOTE= 


Format

NETTERM node-name[,...]

RW

Executes a command in a remote window context on the specified nodes. The remote process is a network process. This command is equivalent to


      DEVTOOLS DO/WINDOW/REMOTE= 

This command may be used to prefix a normal window startup command in order to have the window operate on another node. This other node would normally be a server node within a cluster.

The preferred way to start a remote window is to use the DEVTOOLS DO/INTERACTIVE/WINDOW/REMOTE= command which creates a remote interactive process.


Format

RW node-name[,...] command

RWI

Executes a command in a remote window context on the specified nodes. The remote process is an interactive process. This command is equivalent to


      DEVTOOLS DO/INTERACTIVE/WINDOW/REMOTE= 

This command is typically used to prefix a normal window startup command in order to have the window operate on another node. This other node would normally be a server node within a cluster.


Format

RWI node-name[,...] command

RWX

Executes a command in a remote window context on the specified nodes. The output from the remote execution is directed back to the command node. The remote process is a network process. This command is equivalent to


      DEVTOOLS DO/LOG/WINDOW/REMOTE= 

This command may be used to prefix a normal window startup command in order to have the window operate on another node. This other node would normally be a server node within a cluster.


Format

RWX node-name[,...] command

TELL

Executes a command in a remote context on the specified nodes. The output from the remote execution is directed back to the command node. The remote process is a network process. This command is equivalent to


      DEVTOOLS DO/LOG/REMOTE= 


Format

TELL node-name[,...] command


Parameters

dcl-command

The DCL command to be executed in the context of the resultant process.

Typical commands with the /WINDOW/REMOTE qualifier combination are of the form


      RUN SYS$SYSTEM:DECW$xxxx

where xxxx is a DECwindows application name.


Qualifiers

/AFTER=time

Specifies that a /AFTER qualifier to be applied when submitting the DEVTOOLS DO command to batch.

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

/APPLICATION=app-cod

Specifies the application under which the command should be executed. This qualifier causes the /MOVE qualifier to be assumed by default.

/BATCH

Specifies that the DEVTOOLS DO command should be executed in the context of a batch job.

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

/COMMAND=command

Specifies the command to be executed. By default the commandis specified after the qualifiers attached to the DEVTOOLS DO command. Use of this qualifier causes the DEVTOOLS DO command to interpret all qualifiers on the command line rather than just those following the DEVTOOLS DO command.

/DETACHED

Specifies that the DEVTOOLS DO command should be executed in the context of a detached process.

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

/ENVIRONMENT=envr-cod

Specifies the environment under which the command should be executed. This qualifier causes the /MOVE qualifier to be assumed by default.

/GROUP=grp-cod

Specifies the group under which the command should be executed. This qualifier causes the /MOVE qualifier to be assumed by default.

/HOLD

Specifies that a /HOLD qualifier to be applied when submitting the DEVTOOLS DO command to batch.

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

/INTERACTIVE

Specifies that the DEVTOOLS DO command should be executed in the context of an interactive process.

Use of the /INTERACTIVE qualifier is incompatible with /BATCH, /DETACHED, and /SUBPROCESS. If /REMOTE is present there is no default mode qualifier. If it is not present, then /SUBPROCESS is the default mode qualifier.

/KEEP (Default)

/NOKEEP

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

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

/LOG[=log-file]

/NOLOG

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

By default, if /REMOTE is present, /NOLOG is assumed, otherwise /LOG=SYS$DISK:[]DO.LOG is assumed.

If /REMOTE is present, the /LOG qualifier causes the DEVTOOLS DO command to keep the network link open for the duration of the command execution so that output can be forwarded to the command node. If /NOLOG is present or assumed, the output of the command on the target node(s) will only be present in the remote NETSERVER.LOG.

/MOVE[={CONTEXT|DEFAULT}]

/NOMOVE (Default)

Specifies that the command should be executed under the indicated context. This qualifier relates to the /APPLICATION, /ENVIRONMENT, /GROUP, /USERNAME, /VARIANT and /VERSION qualifiers.

The appropriate CONTEXT command is used to move to the required context and another appropriate CONTEXT command is used to restore the context after the command has executed.

If no explicit context is specified using the /APPLICATION, /ENVIRONMENT, /GROUP, /USERNAME, /VARIANT or /VERSION qualifiers, the value specified with the /MOVE qualifier controls how the context is determined. If no value is specified, the default value is DEFAULT.

If the value specified is CONTEXT, the context under which execution occurs is the same as the users current context.

If the value specified or defaulted to is DEFAULT, the users current device and directory are parsed to determine the context under which execution will take place. This value is useful in starting applications from underneath DECwindows views, since the session manager sets the default device and directory (but not the content) of the process it uses for starting an application to that of the view before executing the command associated with the application.

/NAME=job-name

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

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

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

/NOTIFY

/NONOTIFY

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

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

/PRINT

/NOPRINT (Default)

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

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

/PRODUCT=product-code

Specifies that qualifier defaults for the indicated DECwindows product should be used.

Table 1-4 lists the products currently supported.

Table 1-4 SysWorks DECwindows Application and Utilities Summary
Code Move Description
ACAS Yes ACA Services DECwindows interface
ACMS Yes ACMS/ENTER
ADVISE No DECpc Performance Adviser
ALLIN1 No All-In-1
BASIC Yes Interactive Basic for OpenVMS
BOOKREADER No Bookreader
CALCULATOR No DECwindows Calculator
CALENDAR No DECwindows Calendar
CARDFILER No DECwindows Cardfiler
CDA_VIEWER No VIEW/INTERFACE=DECWINDOWS
CHART No DECchart
CLOCK No DECwindows Clock
CMS Yes CMS/INTERFACE=DECWINDOWS
CREATE_PUBLIC_PROFILE No Create a public DECwindows profile file
DEBUG Yes Multi session DECset debugger
DECISION No DECdecision
DECTERM No DECwindows Terminal
DIALOUT No SET HOST/DTE/NUMBER=
DOCUMENT_GRAPHICS Yes DECdocument Graphics Editor
DTM Yes DTM/INTERFACE=DECWINDOWS
EVE Yes EDIT/TPU/INTERFACE=DECWINDOWS
FAX_OPERATOR No DEXfax Operator
ISOSAHEDRON No DECwindows example isosahedron
LINKWORKS No Linkworks management
LINKWORKS_SETUP No Linkworks login setup
LSEDIT Yes LSEDIT/INTERFACE=DECWINDOWS
MAIL No DECwindows Mail
MAILWORKS No DEC Mailworks
MESSAGES No Extended message window setup
MMS Yes MMS/INTERFACE=DECWINDOWS
MWM No DECwindows Window Manager
NOTES No NOTES/INTERFACE=DECWINDOWS
NOTEPAD No DECwindows Notepad
OBB Yes ObjectBroker
PAUSE No Session Pause
PCA Yes PCA
POLYCENTRE_FILE_OPTIMISER No POLYCENTRE File Optimiser (Defragmenter)
POLYCENTRE_SCHEDULER No POLYCENTRE Scehduler
POSIX No POSIX
PRESENT No DECpresent
PRINT_SCREEN No DECwindows Print Screen
PURGE_WINDOW_PROCESSES No SysWorks unused DECwindow process purge
RDBEXPERT No RdbExpert
SCA Yes SCA/INTERFACE=DECWINDOWS
SET_HOST_LAT No SET HOST/LAT
SOFTPC No SoftPC DECwindows interface
UPDATE_SYSTEM_PROFILE No Update a system DECwindows profile
VUIT Yes VUIT
WRITE Yes DECwrite

/QUEUE=batch-queue-name

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


Previous Next Contents Index