| Previous | Contents | Index |
If this qualifier is specified, the modules referenced by the session-name session are the target; do not specify the mod-name module name parameters.
Sessions can be manipulated via the REPLACE, RESERVE, UNRESERVE, MODIFY SESSION, MODIFY RESERVATION, CREATE MODULE, and CANCEL SESSION commands. And modules created by CREATE MODULE (on a queued-replacement stream) and reserved via RESERVE can be combined into the same session.
| #1 |
|---|
VDE„ MODIFY RESERVATION FOO /REMARK="Fix QARS 32 and 33"
%VDE-I-RESMOD, reservation for module [FACIL]FOO.MAR modified in the database
%VDE-I-COMMIT, database transaction has successfully committed
VDE„ SHOW RESERVATION FOO/FULL
Reservation 1 of [FACIL]FOO.MAR
Reservation created on 29-DEC-1989 13:09:47.27
Reservation created by user SMITH (Jane Smith)
Generation 29 (27B2) reserved from stream V5.4
Expected generation expression at replacement is 27B3
Concurrent reservations are allowed
Remark: Fix QARS 32 and 33
VDE„
|
This example modifies the reservation remarks of all source modules in the default facility with the name FOO. In this case, only module [FACIL]FOO.MAR matches the module name, and its reservation remark is changed. The SHOW RESERVATION command confirms that the reservation now has the new remark.
| #2 |
|---|
VDE„ MODIFY RESERVATION/NOCONCURRENT [FACIL]MOD1.FOR
%VDE-I-RESMOD, reservation for module [FACIL]MOD1.FOR modified in the database
%VDE-I-COMMIT, database transaction has successfully committed
VDE„ SHOW RESERVATION/FULL MOD1.FOR
Reservation 1 of [FACIL]MOD1.FOR
Reservation created on 29-DEC-1989 13:18:34.75
Reservation created by user SMITH (Jane Smith)
Generation 3 (3) reserved from stream MAIN
Expected generation expression at replacement is 4
No concurrent reservations are allowed
Remark: Add new look-up algorithm
VDE„
|
The MODIFY RESERVATION command specifies that concurrent reservations are not allowed for module MOD1.FOR in facility FACIL. The output from the subsequent SHOW RESERVATION command shows that no concurrent reservations are allowed.
| #3 |
|---|
VDE„ MODIFY RESERVATION MOD1.FOR/IDENT=2/REMARK="Fix uninitialized pointer"
%VDE-I-RESMOD, reservation for module [FACIL]MOD1.FOR modified in the database
%VDE-I-COMMIT, database transaction has successfully committed
VDE„ SHOW RESERVATION MOD1.FOR /FULL
Reservation 1 of [FACIL]MOD1.FOR
Reservation created on 24-MAR-1989 11:24:48.77
Reservation created by user SMITH (Jane Smith)
Generation 1 (1) reserved from stream MAIN
Expected generation expression at replacement is 2
Concurrent reservations are allowed
Remark: Fix access violation
Reservation 2 of [FACIL]MOD1.FOR
Reservation created on 24-MAR-1989 11:25:36.85
Reservation created by user SMITH (Jane Smith)
Generation 1 (1) reserved from stream MAIN
Expected generation expression at replacement is 2
Concurrent reservations are allowed
Remark: Fix uninitialized pointer
VDE„
|
This example modifies one of two concurrent reservations of the same module. Because there are concurrent reservations, the MODIFY RESERVATION command must have the /IDENTIFICATION qualifier to specify which reservation to modify. In this case, the command modifies the remark for reservation 2 of [FACIL]MOD1.FOR. The SHOW RESERVATION command confirms that reservation 2 now has the new remark.
Modifies the remark string associated with a VDE script in the VDE database.
MODIFY SCRIPT
The MODIFY SCRIPT command modifies the remark string for a specified VDE script in the VDE database. VDE only modifies the script of the specified type that belongs to the default development stream.You must specify a script-type qualifier to select the script you want modified. See the description of the CREATE SCRIPT command for an explanation of the different types of scripts and how scripts are selected using script-type qualifiers. You must also specify the script segment number unless the default value applies.
Keywords used within scripts are documented in Script Keywords, while script functions are in Script Functions, and script types are in Script Types. For other script-related commands, also see CREATE SCRIPT, DELETE SCRIPT, EXTRACT SCRIPT, INVOKE SCRIPT, and SHOW SCRIPT.
/BUILD
Specifies that the default stream's BUILD script be modified./COMPILE=mod-name
Specifies that the default stream's COMPILE script with the specified mod-name specification be modified./CONFIRM
/NOCONFIRM (default)
Controls whether VDE asks you to confirm that you want each script modified. The /CONFIRM qualifier causes VDE to print a message for each script asking whether you want that script modified. If you answer YES (or Y), the script's attributes are modified in the database. If you answer NO (or N), the script is not modified. The /NOCONFIRM qualifier causes VDE to modify the specified scripts without asking for confirmation./COPY=mod-name
Specifies that the default stream's COPY script with the specified mod-name specification be modified./CREATE_FACILITY
Specifies that the script that VDE invokes when a new facility is created should be modified./DELETE_GENERATION=mod-name
Specifies that the default stream's DELETE_GENERATION script with the specified mod-name specification be modified./DIFFERENCES=mod-name
Specifies that the default stream's DIFFERENCES script with the specified mod-name specification be modified./FETCH=mod-name
Specifies that the default stream's FETCH script with the specified mod-name specification be modified./INSERT_GENERATION=mod-name
Specifies that the default stream's INSERT_GENERATION script with the specified mod-name specification be modified./LINK=mod-name
Specifies that the default stream's LINK script with the specified mod-name specification be modified./LOG (default)
/NOLOG
Controls whether log messages are printed after the script is modified. The /LOG qualifier causes such messages to be printed and the /NOLOG qualifier suppresses them. These messages indicate that the script has been modified and that the database transaction has committed successfully./NEW_STREAM=fac-name
Specifies that the default stream's NEW_STREAM script with the specified fac-name specification be modified./NOKEEP=mod-name
Specifies that the default stream's NOKEEP script with the specified mod-name specification be modified./REMARK="string"
Specifies a new remark string for the script. This string replaces the remark string from the original CREATE SCRIPT command or from a previous MODIFY SCRIPT command. The quoted remark string, which can be up to 132 characters long, may contain any explanatory remark about the script that you want stored in the VDE database./REPLACE=mod-name
Specifies that the default stream's REPLACE script with the specified mod-name specification be modified./RESERVE=mod-name
Specifies that the default stream's RESERVE script with the specified mod-name specification be modified./SEGMENT=seg-num
Specifies the segment number of the script to modify. The seg-num parameter specifies the integer segment number. If you omit this qualifier, VDE modifies the script with segment number 10./SET_FACILITY=fac-name
Specifies that the default stream's SET_FACILITY script with the specified fac-name specification be modified./SET_STREAM
Specifies that the default stream's SET_STREAM script be modified./STAGING=mod-name
Specifies that the default stream's STAGING script with the specified mod-name specification be modified./UNRESERVE=mod-name
Specifies that the default stream's UNRESERVE script with the specified mod-name specification be modified.
| #1 |
|---|
VDE„ MODIFY SCRIPT/COMPILE=*.C/REMARK="New remark string"
%VDE-I-SCRPMOD, script information modified in the database
script to compile module [CODE]*.C (segment 10)
%VDE-I-COMMIT, database transaction has successfully committed
VDE„ SHOW SCRIPT/FULL/COMPILE=[CODE]*.C
Script to compile module [CODE]*.C (segment 10)
Script added to database on 9-DEC-1989 20:34:25.44
Script added to database by user JONES (John Jones)
Remark: New remark string
VDE„
|
This example modifies the script to compile all C modules in facility CODE to have a new remark string. The log messages show that the script was successfully modified. The SHOW SCRIPT/FULL command shows that the database contains the new remark string.
Modifies the attributes of one or more reservation sessions in the VDE database. The attributes of a session you can modify are its name and remark string.Requires RESREP privilege to modify your own session. Requires PERFREP privilege to modify another user's session.
MODIFY SESSION session-name [, session-name...]
session-name
The name of a reservation session whose attributes are to be modified. You can modify more than one session at a time by using wildcard characters in the session name. The percent sign (%) in a session name matches any single character in the position it occupies and the asterisk (*) matches zero or more characters in the position it occupies. VDE modifies the attributes of those sessions whose names match the wildcard pattern.
/CONFIRM
/NOCONFIRM (default)
Controls whether VDE asks you to confirm that you want each reservation session modified. The /CONFIRM qualifier causes VDE to print a message for each session asking whether you want that session modified. If you answer YES (or Y), the session is modified. If you answer NO (or N), the session is not modified. If you enter a session name with a wildcard specification, VDE asks you to confirm the modification of each session whose name matches the wildcard specification. The /NOCONFIRM qualifier causes VDE to modify the specified sessions without asking for confirmation./LOG (default)
/NOLOG
Controls whether log messages are printed after the sessions are modified. The /LOG qualifier causes such messages to be printed and /NOLOG suppresses them. The messages indicate that the sessions have been modified and that the database transaction has successfully committed./NAME=session-name
Specifies a new name for the reservation session. The new session name can be up to 39 characters long and must follow normal VDE name syntax. After the session name has been changed, you must refer to the session by its new name in all subsequent VDE commands. The old name is lost from the database./REMARK="string"
Specifies a new remark string for the session. This string replaces the remark string from the original RESERVE or CREATE SESSION command or from any previous MODIFY SESSION command. The quoted remark string, which can be up to 132 characters long, may contain any explanatory remark about the session that you want stored in the VDE database.
| #1 |
|---|
VDE„ MODIFY SESSION SMITH-2/REMARK="New remark string"
%VDE-I-SESMOD, information for session SMITH-2 modified in the database
%VDE-I-COMMIT, database transaction has successfully committed
VDE„
|
This example modifies session SMITH--2 to give it a new remark string. The log messages show that the session has successfully been modified.
Modifies a build-step definition in the VDE database. This command lets you add or remove individual input and output modules to the build-dependency information of a compile or link step.
MODIFY STEP step-mod-name = mod-name [, mod-name...]
step-mod-name
The name of the module that is compiled or linked by the build step. This name consists of a module name and a type name separated by a period (such as MOD1.PAS) and optionally may include a facility name enclosed in square brackets (such as [FACNAM]MOD1.PAS). The module name may not contain wildcard characters. If no facility name is specified, the default facility is assumed. This module must already exist in the database and it must already have build-dependency information.mod-name
The name of a module that you want to add or remove as an input or output for the build step. This name consists of a module name and a type name (for example, MOD1.OBJ) and may include a facility name enclosed in square brackets (for example, [FACNAM]MOD1.OBJ). If no facility name is specified, the default facility is assumed.You can add or remove many input or output modules by specifying wildcard characters in any component of the module name. The percent sign (%) in a name matches any single character in the position it occupies and the asterisk (*) matches zero or more characters in the position it occupies. Those modules whose names match the wildcard pattern are added to or removed from the build step.
If the output module you specify does not already exist in the database, the MODIFY STEP command adds it to the database. Input modules, however, must already be defined in the database. Also, you cannot specify a source module as an output from a build step.
To be able to perform minimal system builds, VDE records all inputs and outputs for each build step. This information is known as "build dependency information." Normally, VDE collects build dependency information automatically when you perform system builds. For some build steps, however, this is not possible and you must use the CREATE STEP command to enter the build dependency information into the VDE database.The MODIFY STEP command is normally used to edit build step definitions created with the CREATE STEP command. The MODIFY STEP command allows you to change build dependency information in the VDE database by adding or removing individual input and output modules.
Build dependency information is always created in the default development stream. To modify a build step definition for use in more than one development stream, you must use the MODIFY STEP command for each stream. For each stream, first enter the SET STREAM command to set the development stream, then enter the MODIFY STEP command to modify the build dependency information in the VDE database.
/ADD (default)
/REMOVE
Controls whether the modules specified in the parameter list are added to or removed from the build-step definition. The /ADD qualifier adds the specified modules to the build step. The /REMOVE qualifier removes the specified modules from the build step. To set the default for the command as a whole, specify the qualifier after the MODIFY STEP keywords. To override that default for a single module, specify the qualifier after the mod-name parameter you choose to add to or remove from the build step. If you do not specify one of these qualifiers, modules are added to the build step.Of /ADD and /REMOVE, /ADD is the default.
/COMPILE (default)
/COPY
/LINK
Specifies whether the build step to be modified is a compile step, copy step, or link step. /COMPILE modifies a compile step, /COPY modifies a copy step, and /LINK modifies a link step for the specified module.Of /COMPILE, /COPY and /LINK, /COMPILE is the default.
/CONFIRM (default)
/NOCONFIRM
Controls whether VDE asks you to confirm that you want the build-step definition modified. The /CONFIRM qualifier causes VDE to print a message asking whether you want the build step modified. If you answer YES (or Y), the build-step definition is modified. If you answer NO (or N), the build-step definition is not modified. The /CONFIRM qualifier also causes VDE to ask you to confirm the addition or removal of each individual input or output module for the build step. The /NOCONFIRM qualifier causes VDE to modify the build-step definition without asking for confirmation./INPUT (default)
/OUTPUT
Specifies whether the mod-name parameters are inputs to or outputs from the build step. The /INPUT qualifier designates the specified modules as inputs in the build-step definition. The /OUTPUT qualifier designates the specified modules as outputs in the build-step definition. To set the default for the command as a whole, specify the qualifier after the MODIFY STEP keywords. To override that default for a single module, specify the qualifier after the mod-name parameter you choose to mark as an input or output.Of /INPUT and /OUTPUT, /INPUT is the default.
/LOG (default)
/NOLOG
Controls whether log messages are printed after the build step definition is modified in the database. The /LOG qualifier causes the messages to be printed and the /NOLOG qualifier suppresses them. The messages indicate that the build step has been modified, that the specified modules have been added to or removed from the step, and that the database transaction has committed successfully.
| #1 |
|---|
VDE„ MODIFY STEP MOD4.FOR = FOO.FOR/INPUT, MOD4.ANA/OUTPUT
%VDE-I-COMSTEPMOD, compile step for module [CODE]MOD4.FOR modified in database
%VDE-I-MODINSTEP, module [CODE]FOO.FOR is an input to the build step
%VDE-I-MODOUTSTEP, module [CODE]MOD4.ANA is an output from the build step
%VDE-I-COMMIT, database transaction has successfully committed
VDE„ SHOW STEP/FULL MOD4.FOR
Compile Step for module [CODE]MOD4.FOR
Dependency links for stream V2.1 follow
Inputs to the build step:
Module [CODE]MOD4.FOR
Module [CODE]FOO.FOR
Outputs from the build step:
Module [CODE]MOD4.$OBJ
Module [CODE]MOD4.LIS
Module [CODE]MOD4.ANA
Build step has 2 inputs and 3 outputs
VDE„
|
This example modifies the build dependency information for the build step that compiles module MOD4.FOR. The command adds module FOO.FOR as an input to the step and adds module MOD4.ANA as an output from the step. The SHOW STEP command shows that the new input and output modules have been added to the build dependency information for the step.
| #2 |
|---|
VDE„ MODIFY STEP/LINK MOD1.EXE = FOO.$OBJ/REMOVE/INPUT, MOD1.MAP/ADD/OUTPUT
%VDE-I-LNKSTEPMOD, link step for module [CODE]MOD1.EXE modified in database
%VDE-I-MODREMINSTEP, module [CODE]FOO.$OBJ removed as an input to build step
%VDE-I-MODOUTSTEP, module [CODE]MOD1.MAP is an output from the build step
%VDE-I-COMMIT, database transaction has successfully committed
VDE„ SHOW STEP/LINK/FULL MOD1.EXE
Link Step for module [CODE]MOD1.EXE
Dependency links for stream V2.1 follow
Inputs to the build step:
Module [CODE]MOD1.$OBJ
Module [CODE]MOD2.$OBJ
Outputs from the build step:
Module [CODE]MOD1.EXE
Module [CODE]MOD1.MAP
Build step has 2 inputs and 2 outputs
VDE„
|
This MODIFY STEP command modifies the build dependency information for the build step that links module MOD1.EXE. The command removes FOO.$OBJ as an input to the build step and adds MOD1.MAP as an output from the step. The SHOW STEP command confirms that the changes have been made to the step's build dependency information.
Modifies the attributes of one or more development streams in the VDE database.
MODIFY STREAM stream-name [, stream-name...]
stream-name
The name of a stream in the current VDE library whose attributes are to be modified. You can modify more than one stream at a time by using wildcard characters in the stream name. The percent sign (%) in a stream name matches any single character in the position it occupies and the asterisk (*) matches zero or more characters in the position it occupies. VDE modifies the attributes of those streams whose names match the wildcard pattern.The stream name can be up to 39 characters long. It must follow VDE name syntax. Unlike other VDE names, the stream name can contain periods (.). The use of the facility prefix VDE$ is expressly prohibited.
/CMS_CLASS
/NOCMS_CLASS
Sets or clears the CMS-class attribute of the stream. The /CMS_CLASS qualifier causes VDE to create a CMS class with the same name as the stream in each facility's CMS library and to then maintain that class when the REPLACE command and certain other commands change what module generations belong to the stream. The /NOCMS_CLASS qualifier causes VDE to not maintain a CMS class for the stream.The /CMS_CLASS qualifier interacts with the /INIT_CMS_CLASS and /NOINIT_CMS_CLASS qualifiers; see the descriptions of these qualifiers for details.
You must have the CRESTRM privilege to use these qualifiers.
/CONFERENCE=file-spec
/NOCONFERENCE
Specifies whether a Notes conference for replacement information should be associated with the new stream. The /CONFERENCE qualifier specifies that the notes conference given by the file-spec parameter should be used to record all replacements into the stream. VDE then enters a new note into the conference for each queued or immediate replacement and a reply to that note when a queued replacement is actually performed. The /NOCONFERENCE qualifier specifies that no such notes conference should be used.Under normal circumstances, just the file name should be specified in the file-spec parameter. VDE applies defaults to the notes conference file specification based on the translation of the logical name VDE$NOTES_LIBRARY. If this logical name is not defined, the default file specification "NOTES$LIBRARY:.NOTE" is applied to the file-spec parameter.
/CONFIRM
/NOCONFIRM (default)
Controls whether VDE asks you to confirm that you want each stream definition modified. The /CONFIRM qualifier causes VDE to print a message for the specified stream giving the name of the stream and asking whether you want to modify that stream. If you answer YES (or Y), its attributes are modified. If you answer NO (or N), its attributes are not modified. The /NOCONFIRM qualifier causes VDE to modify the attributes of the stream without asking for confirmation./DELETE
/NODELETE (default)
Sets or clears the delete attribute for the stream. This attribute allows the stream to be deleted with the DELETE STREAM command. The /DELETE qualifier sets the delete attribute so that the stream can be deleted. The /NODELETE qualifier clears the delete attribute so that the stream cannot be deleted without first resetting the attribute. You must have the CRESTRM privilege to use these qualifiers./LOG (default)
/NOLOG
Controls whether log messages are printed after the stream definitions are modified. The /LOG qualifier causes such messages to be printed and /NOLOG suppresses them. The messages indicate that the stream definitions have been modified and that the database transaction has successfully committed./INIT_CMS_CLASS
/NOINIT_CMS_CLASS
Specifies whether VDE initializes the CMS class for the stream in each facility's CMS library when the /CMS_CLASS qualifier specifies that such a class should be maintained. /INIT_CMS_CLASS sets an attribute that causes the MODIFY STREAM command with the /CMS_CLASS qualifier to create and populate a CMS class with the same name as the stream in each facility. /NOINIT_CMS_CLASS clears this attribute so that MODIFY STREAM does not create or populate such CMS classes. /NOINIT_CMS_CLASS is useful for very large VDE libraries where the initialization of CMS classes take an excessively long time. For such libraries, it is better to use a separate command procedure to initialize the desired CMS classes; such a procedure can process the facilities of your library in parallel for faster completion.You must have the CRESTRM privilege to use these qualifiers.
/NAME=stream-name
Specifies a new name for the stream. The stream name can be up to 39 characters long and must follow normal VDE name syntax, except that a stream name can contain periods (.) . After the stream name has been changed, you must refer to the stream by its new name in all subsequent VDE commands. The old name is lost from the database./NOSUCCESSOR[=(succ-name [, succ-name...])]
Specifies streams that should no longer be successors to the stream being modified. A successor to a stream is another stream to which source changes are propagated by the REPLACE command. Each succ-name parameter specifies the name of a stream that is currently a successor to the stream given by the stream-name parameter, but that no longer should be a successor. The specified streams are thus removed from the list of successors stored in the database.If the list of succ-name parameters is omitted, all current successors of the stream being modified are removed from that stream's successor list.
Previous Next Contents Index