DMSUPPORT Specification

The DMSUPPORT specification designates the title of the DMSUPPORT code file for the database.

The following diagram illustrates the syntax for specifying the DMSUPPORT code file:

<DMSUPPORT specification>

── DMSUPPORT ── = ──<file title>───────────────────────────────────────┤

Explanation

The file title can include a usercode and a family specification. If no MODEL option is present, the default title for the DMSUPPORT code file is 

DMSUPPORT/<database name>

For a database using the data path specification, the default title of the DMSUPPORT library is 

<path name>/<database name>/DMSUPPORT/<database level>

The database level is the database update level. The MODEL option cannot be used with the data path specification.

With a MODEL option, the default DMSUPPORT title is taken from the description file used for the modeling.

Family substitution occurs at run time for the default title.

The file title is contained in the control file. At run time, the title is used to initiate the correct version of the software. Both the usercode of the running task and the family substitution have an effect on which version, if any, of the software is found. To ensure the correct version of the software is found, explicitly specify the file title and include a usercode and a family name.

Note: On a system with the DMALGOLUNSAFE option set, use the MP system command, with the EXECUTABLE option, to make the DMSUPPORT code file in an executable code file before performing any database operations, such as database initialization. Otherwise, the DMSUPPORT library will not run and the database will be inaccessible.
Note: For more information on the DMALGOLUNSAFE option, refer to the MCP Security Overview and Implementation Guide. For more information on the MP system command, see the System Commands Operations Reference Manual.

Example

The following statement defines the name of the DMSUPPORT code file as DMSUPPORT/<database name>. The code file is located under the USER2 usercode on the PACK2 pack. 

DMSUPPORT = (USER2)DMSUPPORT/<database name> ON PACK2;
Note: DASDL copies the old DMSUPPORT to DMSUPPORT/<database name>/<update level - 1> or DMSUPPORT/<database name>/<update level - 1>/<timestamp> if DMSUPPORT/<database name>/<update level - 1> exists. This copy is only available if all of the following are valid:

  • The update level is increased due to a DASDL UPDATE.

  • Reorganization is not required.

  • The ZIP compiler control option is set.

  • The DMSUPPORT file is not in the permanent directory.

If the current user does not have permission to copy the file, DASDL emits a security warning message. In addition, if the DMSUPPORT code file is specified without the usercode included, DASDL assumes that the old DMSUPPORT code file is under the current running usercode.
Prev  Up  Next
Accessroutines Specification  Home  DMReorganization Specification