| Previous | Contents | Index |
This appendix describes the various logical names used by SysWorks in alphabetic order.
An application environment logical name which indicates whether ACMS sources include their own ADU command, or whether one has to be provided for them.
An internal logical name of SysWorks
An application environment logical name indicating which prefices and suffices to use in generated CDD/Repository definitions. If true, use a directory prefix such as appl_FIELDS. and appl_RECORDS., otherwise use name prefix and suffix such as appl_ and _REC.
Indicates the name of the CMS group to be automatically used in association with the application's CMS library.
An application environment logical name indicating the preferred default for DEVTOOLS CMS commands which use the /PATH list qualifier.
It indicates a list of the CMS generations to be automatically used in association with the application's CMS library instead on the latest from the mainline.
If this logical name is present, the DEVTOOLS CMS and SRCCTL commands will delete, fetch, reserve etc. the first generation found in this list.
This behaviour is significantly different to using these commands from CMS itself. If this logical name is not present, the DEVTOOLS CMS and SRCCTL actions will be performed on the main line of descent in the CMS library, much as they would with a direct CMS command.
An application environment logical name indicating the preferred default for DEVTOOLS CMS commands which use the /VARIANT qualifier.
It indicates the letter to be used in automatically creating variant generations in the application's CMS library.
When this logical is used, the DEVTOOLS CMS and SRCCTL commands extends the functionality of the CMS CREATE ELEMENT command such that when a new element is created, it is reserved and replaced so that a variant exists. This is useful in conjunction with the appl_CMS_PATH logical name. Using them together, a maintenance or maintenance testing class will always have variant generations as members.
By default, variants are not created. A typical value would be the letter A for maintenance and maintenance testing environments.
Indicates the style of development and maintenance application environment directories. Permitted values include:
| Code | Usage |
|---|---|
| COMMON | Developers share common documentation, library, software and work directories. This is the default development style. |
| INDIVIDUAL | Each developers work sub-directory is placed at the beginning of a search list for the documentation, library, software and work directory logical names. This style should not be used when ACMS is being used, as ACMS cannot use search lists to replace objects. |
| PRIVATE | Developers do not have sub-directories below the runtime and work directories, or sub-directories below their login default directory for each application environment to which they have been granted access. It is up to the application to decide where to set the developers default directory. This is typically done within the application's ENTER.COM command procedure. |
| SPECIFIC |
An application environment specific default development environment code.
An application environment specific default development testing environment code.
An application environment specific default maintenance environment code.
An application environment specific default maintenance testing environment code.
A variable indicating the default image identification prefix used during builds. If this logical name is not defined, the application code is used as the image identification prefix by default. Any explicit IDENTIFICATION clause in an images linker options file overrides the default image identification.
The date and time at which the application environments LOGICALS.COM command procedure was last executed. This is used so that the application environments logical name table will be repopulated when a new version of the LOGICALS.COM command procedure is built.
A variable indicating the current state of an application. This is normally set to available after the application environments LOGICALS.COM command procedure has been executed.
A variable indicating the version of the application.
The application version is used for the following:
An application environment data directory. If an application has multiple data directories, this logical name should be a search list including each such directory.
An application environment documentation directory.
An application environment journal directory.
An application environment library directory.
An application environment runtime directory.
An application environment software directory.
An application source directory.
An application source directory root. For example:
FIN_SRC_ROOT:[CMSLIB] |
would be the directory specification for a typical CMS library.
An application environment work directory.
The application CMS library. This logical should have one of the following values:
A replica of the CUR_APP symbol.
A replica of the CUR_ARC symbol.
A replica of the CUR_ENV symbol.
A replica of the CUR_GRP symbol.
A replica of the CUR_SCP symbol.
A replica of the CUR_TYP symbol
A replica of the CUR_USR symbol.
A logical name set by DECwindows/Motif which indicates the screen density in dots per inch.
This logical name points to the directory which contains all the users DECwindows control files. It either points to s sub-directory of [.DECW] in the users home directory or directly to the users home directory itself (if the [.DECW] sub-directory is not present).
A logical name set by DECwindows/Motif which indicates the horizontal screen size in pixels. Typical values include 1024 and 1280.
A logical name set by DECwindows/Motif which indicates the vertical screen size in pixels. Typical valies include 768, 864 and 1024.
The search list of all the DISK_envr: search lists.
The search list of all DISK$volume: logical names.
The logical name for a mounted disk volume.
The search list for a logical disk.
This logical name indicates the list of phases to use when the BUILD/PHASES=ALL qualifier is used. Note that by default, /PHASES without an argument assumes /PHASES=DESCRIP. The default phase list if this logical cannot be translated is /PHASE=(SETUP,SCAN,RULES,DESCRIP). See the BUILD command in the Command Dictionary for more details on phases.
Specifies the DCL command used for captive users. The default command is:
@SWRK_SFT_DIR:SWRK_MENU_SYSTEM
|
This logical name may be set explicitly in the system logical name table or implicitly in the SysWorks logical name table by virtue of being a system variable.
Specifies the entry command (i.e. parameter) to be applied to the captive user command.
This logical name may be set explicitly in the system logical name table or implicitly in the SysWorks logical name table by virtue of being a system variable.
Indicates which utilities (if any) are automatically started as kept sub-processes by SysWorks.
When a user logs in, SysWorks checks this logical name and defines the standard symbols for the utilities indicated to execute a DCL command procedure which starts the kept sub-rpocess (if not currently present) and ATTACHes to it.
Each utility name is separated by a backslash and is allowed to have one asterisk present as per the DCL symbol assignment syntax.
The following utility codes are currently supported:
| #1 |
|---|
$define swrk_spawn_commands "cdo\ed*it\mail"
|
This command indicates that the CDO utility (i.e. DICTIONARY OPERATOR), an editor (i.e. LSEDIT if present otherwise EVE) and MAIL are to be automatically started as kept sub-processes and ATTACHed to when used. Note that the EDIT symbol allows ED and EDI as abbreviations.
This system logical name logical should point to the following MMS script:
SWDOC_SFT_DIR:SWRK_MMS_RULES.MMS |
The node specific system root as defined by OpenVMS.
The node specuific system root for node node as defined by SysWorks turnkey startup.
A search list of all the SYS$SPECIFIC_node: logical names defined by SysWorks turnkey startup.
A search list of all the directories which the DECwindows/Motif session manager checks for profile files during its startup and when the Options J Menus... task is selected from the session manager menus.
This section describes each of the global symbols used by SysWorks to control or modify its behaviour.
Symbols of the form CUR_xxx are set by various CONTEXT sub-commands. Where lists of such sub-commands which set a symbol or clear a symbol are provided, sub-commands which are not in either list do not change the symbols value.
Symbols of the form DIR_xxx are managed by an application. If they are used, they are defined in the applications ENTER.COM and deleted in the applications EXIT.COM.
Symbols of the form SDC_xxx are managed at a system wide level and are normally defined in the site specific pre-login procedure SWRK_LCL_DIR:site_PRE_LOGIN.COM.
Indicates the name of the application of the users context. Blank when the CUR_TYP symbol doesn't contain the keyword APPLICATION.
This symbol is set by the CONTEXT APPLICATION command and cleared by the CONTEXT GROUP, CONTEXT HOME and CONTEXT USER commands.
Indicates the architecture of the node on which the process exists. Blank when multi-architecture support is not provided at a system or application environment level or the CUR_TYP symbol doesn't contain the keyword APPLICATION.
This symbol is set or cleared by the CONTEXT APPLICATION, CONTEXT ENVIRONMENT, CONTEXT VARIANT and CONTEXT VERSION commands and cleared by the CONTEXT GROUP, CONTEXT HOME and CONTEXT USER commands.
Indicates the environment of the users context. Blank when the CUR_TYP symbol doesn't contain the keyword APPLICATION.
This symbol is set by the CONTEXT APPLICATION and CONTEXT ENVIRONMENT commands and cleared by the CONTEXT GROUP, CONTEXT HOME and CONTEXT USER commands.
Indicates the name of the group of the users context. Blank when the CUR_TYP symbol doesn't contain the keyword GROUP.
This symbol is set by the CONTEXT GROUP command and cleared by the CONTEXT APPLICATION CONTEXT HOME and CONTEXT USER commands.
Indicates the scope of the users context. Blank when the CUR_TYP symbol doesn't contain the keyword APPLICATION.
This symbol should contain one of the following keywords:
This symbol is set by the CONTEXT APPLICATION, CONTEXT ENVIRONMENT, CONTEXT VARIANT and CONTEXT VERSION commands and cleared by the CONTEXT GROUP, CONTEXT HOME and CONTEXT USER commands.
Indicates the type of the users current context.
This symbol should contain one of the following keywords:
It is set by the CONTEXT APPLICATION, CONTEXT ENVIRONMENT, CONTEXT GROUP, CONTEXT HOME and CONTEXT USER commands.
Indicates the name of the user when the users current context is their home or personal context.
This sybol is set by the CONTEXT HOME and CONTEXT USER commands, and cleared by the CONTEXT APPLICATION and CONTEXT GROUP cxommands.
Indicates the development variant of the users context. Blank when the CUR_TYP symbol doesn't contain the keyword APPLICATION.
This symbol is set by the CONTEXT APPLICATION, CONTEXT ENVIRONMENT and CONTEXT VARIANT commands and cleared by the CONTEXT GROUP, CONTEXT HOME and CONTEXT USER commands.
Indicates the maintenance version of the users context. Blank when the CUR_TYP symbol doesn't contain the keyword APPLICATION.
This symbol is set by the CONTEXT APPLICATION, CONTEXT ENVIRONMENT and CONTEXT VERSION commands and cleared by the CONTEXT GROUP, CONTEXT HOME and CONTEXT USER commands.
Indicates the directory specification of an alternate CDD/Plus or CDD/Repository root directory. By default appl_sdc-cdd_DIR is assumed when this symbol is not present.
Normally this symbol is application dependent and should thus be set in the applications' ENTER.COM command procedure and cleared in the applications' EXIT.COM command procedure.
Indicates the directory specification of an alternate documentation directory. By default appl_sdc-doc_DIR is assumed when this symbol is not present. Normally this symbol is application dependent and should thus be set in the applications' ENTER.COM command procedure and cleared in the applications' EXIT.COM command procedure.
Indicates the directory specification of an alternate journal directory. By default appl_sdc-jnl_DIR is assumed when this symbol is not present. Normally this symbol is application dependent and should thus be set in the applications' ENTER.COM command procedure and cleared in the applications' EXIT.COM command procedure.
Indicates the directory specification of an alternate kit directory. By default appl_sdc-kit_DIR is assumed when this symbol is not present. Normally this symbol is application dependent and should thus be set in the applications' ENTER.COM command procedure and cleared in the applications' EXIT.COM command procedure.
Indicates the directory specification of an alternate library directory. By default appl_sdc-lib_DIR is assumed when this symbol is not present. Normally this symbol is application dependent and should thus be set in the applications' ENTER.COM command procedure and cleared in the applications' EXIT.COM command procedure.
| Previous | Next | Contents | Index |