Starts a inactive server.

Format

SCU START SERVER server-name

Parameters

server-name

The name of the server on which to perform the operation. Valid server names are from 1 to 31 characters from the symbol name character set.

Examples

$ SCU START SERVER SWRK_NET_SERVER
      

This SCU START SERVER command starts the SWRK_NET_SERVER server process.

Stops a running server.

Format

SCU STOP SERVER server-name

Parameters

server-name

The name of the server on which to perform the operation. Valid server names are from 1 to 31 characters from the symbol name character set.

Examples

$ SCU STOP SERVER SWRK_NET_SERVER
      

This SCU STOP SERVER command stops the SWRK_NET_SERVER server process.

Suspends a running server.

Format

SCU SUSPEND SERVER server-name

Parameters

server-name

The name of the server on which to perform the operation. Valid server names are from 1 to 31 characters from the symbol name character set.

Examples

$ SCU SUSPEND SERVER SWRK_NET_SERVER
      

This SCU SUSPEND SERVER command suspends operation of the SWRK_NET_SERVER server process.

Invokes the source control menu and CMS front end.

Format

SRCCTL [sub-command]

The following sections provide information about each of the tasks which can be selected from the source control menu.

Invoke an application build. This is similar to the BUILD command, except that a series of questions are asked rather than qualifiers being used.

Invokes the change control menu.

See CHGCTL for more details.

Format

SRCCTL CHGCTL

Invokes CMS directly. This is used when there is no replacement SRCCTL command.

Create a CMS object.

See DEVTOOLS CMS CREATE ELEMENT for more details.

Delete a CMS object.

See DEVTOOLS CMS DELETE ELEMENT for more details.

Perform a DCL directory command.

Edit one or more files.

Fetch a CMS element.

See DEVTOOLS CMS FETCH for more details.

Rename a CMS object.

See DEVTOOLS CMS RENAME ELEMENT for more details.

Replace a reserved CMS element.

See DEVTOOLS CMS REPLACE for more details.

Generates a report about a CMS library. See DEVTOOLS CMS REPORT for more details.

Examples

$ srcctl report
Version [V2.0]: V1.0
Development environment [DEV]:
Development testing environment [DTST]:
Maintenance environment [MNT]:
Maintenance testing environment [MTST]:
Output [SYS$OUTPUT]:
Display (All/New/Unused) [All]: NEW,UNUSED
Execution (Batch/Detached/Online/Subprocess) [Batch]: ONLINE
      

This example generates a report listing elements which are not in the release class or are not in any class. The report is generated online.

Reserve a CMS element.

See DEVTOOLS CMS RESERVE for more details.

Show CMS objects.

See DEVTOOLS CMS SHOW CLASS, DEVTOOLS CMS SHOW ELEMENT, DEVTOOLS CMS SHOW GROUP, DEVTOOLS CMS SHOW HISTORY, DEVTOOLS CMS SHOW RESERVATIONS, for more details.

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

See TSTCTL for more details.

Format

SRCCTL TSTCTL

Unreserve a reserved CMS element.

See DEVTOOLS CMS UNRESERVE for more details.

Invokes the version control menu.

See VSNCTL for more details.

Format

SRCCTL VSNCTL

Invokes the SYSTOOLS utility.

Format

SYSTOOLS [sub-command]

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

Adjust the system clock, which is used both as a timer to record intervals between various internal events, and as a source clock for displaying the time of day. This adjustment is made slowly in order to preserve the monotonicity of system time.

Requires the CMKRNL (change mode to kernel), OPER (operator) and LOG_IO (logical I/O) privileges.

Format

SYSTOOLS ADJUST TIME time

Parameters

time

Specifies a date in the format day-month-year, or a time in the format hour:minute:second.hundredth, or both. These fields accept the following values:

Field	Type	Values
Day	Integer	1 to 31
Month	String	JAN, FEB, MAR, APR, MAY, JUN, JUL, AUG, SEP, OCT, NOV, or DEC
Year	Integer	1858 to 9999
Hour	Integer	0 to 23
Minute	Integer	0 to 59
Second	Integer	0 to 59
Hundredth	Integer	0 to 99

The hyphens (-), colons (:) and period (.) are required delimiters. Separate the date and time, when both are specified, with a colon. The syntax is sometimes specified as follows:

[dd-mmm-yyyy[:]] [hh:mm:ss.cc]

If the explicit time value is not specified, the interval system clock is automatically reset according to the time-of-year clock.

Note that the time-of-year clock is optional for some processors. For further information about the time-of-year clock, see the VAX Hardware Handbook.

Examples

$ ADJUST TIME=19-FEB-1995:19:31:0.0
      

The ADJUST TIME command in this example sets the date and time to 19th of October 1993, 7:31 P.M.

$ SHOW TIME 
  31-FEB-1995 02:00:01:23
$ ADJUST TIME=+1:00
$ SHOW TIME 
  31-FEB-1995 02:00:01:45
$ SHOW TIME 
  31-FEB-1995 07:00:02:35
      

The ADJUST TIME command in this example sets the system time forward by one hour. Note that the time has barely moved by the time of the second SHOW TIME command. The third show time command is entered four elapsed hours later, but the system time has progressed by five hours.

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

The SYSTOOLS ATTACH and SYSTOOLS 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

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

$ SYSTOOLS ATTACH JONES_2
      

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

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

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

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

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

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

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

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

Delete a permanent global section.

Format

SYSTOOLS DELETE/GLOBAL_SECTION global-section

Parameters

global-section

The name of the global section to be deleted.

Qualifiers

/GROUP

Specifies that the global section is a group global section in the same group as the user.

/SYSTEM

Specifies that the global section is a system global section.

Examples

$ SYSTOOLS DELETE/GLOBAL_SECTION FIN_001
      

Forces the image currently active for a process to exit.

Format

SYSTOOLS FORCE/EXIT [process-name]

Parameters

process-name

The name of the process whose current image is to be exited.

Qualifiers

/IDENTIFICATION=pid

Specifies the system-assigned process identification (PID) code. When you create a process with the RUN command, the RUN command displays the PID code of the newly created process. The /IDENTIFICATION qualifier can be used in place of the process name parameter.

You can omit any leading zeros in specifying the PID code. the user.

Exits the SYSTOOLS utility. You can also exit from SYSTOOLS by pressing [Ctrl/Z].

Format

SYSTOOLS EXIT

Parameters

None.

Qualifiers

None.

Enables you to obtain information about the SYSTOOLS utility.

To obtain information about all of the SYSTOOLS commands, enter the following command:

SYSTOOLS> HELP

To obtain information about individual commands or topics, enter the HELP command followed by the command or topic name.

Format

SYSTOOLS HELP topic

Parameters

topic

Indicates a topic about which you want information. To display the list of available topics, enter the HELP command at the SYSTOOLS> prompt.

Qualifiers

None.