SysWorks©

SysWorks
Command Reference Manual


Previous Contents Index


DEVTOOLS SPLIT

Invokes the CMS class update component of the SPLIT task from the version control menu. See VSNCTL SPLIT for details of the SPLIT task.

Format

DEVTOOLS SPLIT release-class/qualifiers


Parameters

release-class

This required qualifier indicates the class from which the split should take place. Typically this class is a release class created by the VSNCTL RELEASE task. See VSNCTL RELEASE for details of the RELEASE task.

Qualifiers

/MAINLINE=([DEVELOPMENT=development-class],[TESTING=testing-class])

/NOMAINLINE

Specifies the classes into which the new mainline generations will be inserted. There is no default value - if /MAINLINE is used, at least one class name must be supplied as its value.

/MERGE

/NOMERGE

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

/VARIANT=([MAINTENANCE=maintenance-class],[TESTING=testing-class])

/NOVARIANT

Specifies the classes into which the new variant generations will be inserted. There is no default value - if /VARIANT is used, at least one class name must be supplied as its value.

DEVTOOLS SRCCTL

Invokes the source control menu and CMS front end. See SRCCTL for details.

DEVTOOLS TRIAL

Invokes the TRIAL task from the version control menu. See VSNCTL TRIAL for details.

DEVTOOLS TOUCH

Touches one or more files by changing their modification date and time.

Format

DEVTOOLS TOUCH filespec[,...]


Parameters

filespec[,...]

Specifies one or more files to have their modification date and time updated.

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

/IF_CREATE

/NOIF_CREATE (Default)

Indicates whether a file should be created if it is not present and didn't have any wildcards in its specification.

By default, an error is generated if a file to be touched is not present.

An error is always generated when a file is not present and it has wildcards in its specification.

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

/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 alternative directories which may be checked for files to be touched.

By default the directories are those associated with the application.

Specifies the subcontext in which the command or commands within a subcontext block should execute.

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

By default the directories are those associated with the application.


Examples

#1

$ DEVTOOLS SEARCH TOUCH FIN_SFT_DIR:*.RBF
      

Cause the modification date and time of all the .RBF files in the FIN_SFT_DIR: directory to be updates to the current system date and time.


DEVTOOLS TSTCTL

Invokes the test control menu if DEC Test Manager (DTM) is present and licensed. See TSTCTL for details.

DEVTOOLS VSNCTL

Invokes the version control menu. See VSNCTL for details.

DIRTOOLS

Invokes the DIRTOOLS utility.

Format

DIRTOOLS [sub-command]

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

Transfers control from your current process (which then hibernates) to the specified process.

The DIRTOOLS ATTACH and DIRTOOLS SPAWN commands cannot be used if your terminal has an associated mailbox.

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


Format

DIRTOOLS ATTACH [process-name]


Parameters

process-name

Specifies the name of a parent process or spawned subprocess to which control passes. The process must already exist, be part of your current job, and share the same input stream as your current process. However, the process cannot be your current process or a subprocess created with the /NOWAIT qualifier.

Process names can contain from 1 to 15 alphanumeric characters. If a connection to the specified process cannot be made, an error message is displayed.

Exactly one of the process-name parameter or /IDENTIFICATION or /PARENT qualifiers must be specified. No combinations are allowed.


Qualifiers

/IDENTIFICATION=pid

Specifies the process identification (PID) of the process to which terminal control will be transferred. Leading zeros can be omitted.

Exactly one of the process-name parameter or /IDENTIFICATION or /PARENT qualifiers must be specified. No combinations are allowed.

/PARENT

Indicates that you want to attach to the parent process of your current process. If you did not access the DIRTOOLS utility by using the SPAWN command, an error message is displayed.

Exactly one of the process-name parameter or /IDENTIFICATION or /PARENT qualifiers must be specified. No combinations are allowed.


Examples

#1

$ DIRTOOLS ATTACH JONES_2
      

The ATTACH command transfers the terminal's control to the subprocess JONES_2.

#2

DIRTOOLS> ATTACH/IDENTIFICATION=30019
      

The ATTACH command switches control from the current process to a process having the PID 30019. Notice that because the /IDENTIFICATION qualifier is specified, the process-name parameter is omitted.


DIRTOOLS DEFINE/KEY

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

DIRTOOLS 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 DIRTOOLS 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

#1

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

#2

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

#3

DIRTOOLS> DEFINE/KEY PF2 "SET "/SET_STATE=ALTERED
DIRTOOLS> 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).

#4

DIRTOOLS> DEFINE/KEY PF4 "SET " /SET_STATE=ALTERED
DIRTOOLS> DEFINE/KEY KP7 "FILE" /TERMINATE /IF_STATE=ALTERED
DIRTOOLS> DEFINE/KEY KP8 "FORWARD" /TERMINATE /IF_STATE=ALTERED
DIRTOOLS> 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, DIRTOOLS 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, DIRTOOLS 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, DIRTOOLS executes the SET WASTEBASKET command.


Previous Next Contents Index