DSM Template Services Manual

Template Language
DSM Template Services Manual—427187-004
3-10
SHARED_SSID Statement
•
To change the subsystem name associated with installed templates, set
=_EMS_TEMPLATES DEFINE to an empty file while you create the template
object file. Then you can merge the new and old templates by using TEMPLI. If
you specify the files in the proper order, the new name can replace the old name
for the application’s templates. For more information, see How TEMPLI Merges
Template Files on page 5-9.
SHARED_SSID Statement
Certain applications share token definitions by simply copying a common set of DDL
definitions into the DDL definition file for each application. Using the SHARED_SSID
statement, these applications can also share templates. One of the applications (for
example, ABC) defines the templates to be shared. Each of the other applications
inserts a SHARED_SSID statement that refers to ABC in its template source file.
To share format templates that the EMSTEXT procedure uses, add a SHARED_SSID
statement. However, to share token definitions and templates that the
SPI_BUFFER_FORMAT procedures use, you must add an SSID clause to each
TOKEN-CODE statement that will be shared between applications and also add a
SHARED_SSID statement to the template file that needs the shared information.
ZSPI and most ZEMS tokens are shared automatically. You do not need to include
their subsystem IDs (ZSPI-VAL-SSID and ZEMS-VAL-SSID) in SHARED_SSID
statements.
The syntax for the SHARED_SSID statement is:
subsystem-ID
is the name of a DDL DEFINITION statement that has the format of a subsystem
ID (internal form) and is initialized to the subsystem ID value. It specifies one or
more subsystem IDs to use as key parts in finding a template. This directs
Template Services to use each of the specified alternative subsystem IDs if the
search using the original subsystem ID does not find the template.
Example
Many applications use ZCOM tokens by including the ZCOM DDL definitions in their
own DDL definition files. Each application that uses ZCOM should place this statement
in its template source file:
SHARED_SSID: ZCOM-VAL-SSID
When Template Services looks up a template for ABC but fails to find one, it looks
again among the ZCOM templates.
SHARED_SSID: subsystem-ID [, subsystem-ID ] ...