TRANSFER Programming Manual

User-Supplied Profile Records and Modules
TRANSFER Services
5–12 40970 Tandem Computers Incorporated
User-Supplied Profile
Records and Modules
In addition to the standard profile records created and managed by the TRANSFER
delivery system, your application can allow the writing of user-supplied profile
records to the Profile file. These are records whose structure, format, and content are
defined by your application.
The ADMIN application provides predefined escape functions so that your application
can create and manage these records through user-supplied profile modules. These
are SCREEN COBOL programs that you write and provide for this purpose.
To invoke a module, an operator presses the user-supplied profile (F9) function key on
the ADMIN application Main Menu screen. The module then typically presents a
screen that allows the operator to display and update the user-supplied profile
records. Any restrictions on the use of this screen are defined by the module.
The ADMIN application calls the user-supplied profile module through the following
calling sequence:
CALL ADMIN-PROFILE-USER USING LNKSC-IPC-HDR-L,
LNKSD-LINKAGE-BLOCK,
LNKSE-ERROR-BLOCK.
The parameters passed by this call to the user-supplied module are the same as the
first three parameters in the calls that invoke agent configuration or deletion
programs.
User-Supplied System
Control Modules
A user-supplied system control module provides the means to set parameters for
controlling the operating environment of your TRANSFER applications. This module,
which displays one or more screens, is called by the ADMIN application when the SF9
function key is pressed from the Main Menu screen. This SCREEN COBOL module
must be named ADMIN-SYSTEM-USER. The calling sequence for the user-supplied
system control module is:
CALL ADMIN-SYSTEM-USER USING LNKSC-IPC-HDR-L,
LNKSD-LINKAGE-BLOCK,
LNKSE-ERROR-BLOCK.
The parameters passed by this call to the user-supplied module are the same as the
first three parameters in the calls that invoke agent configuration and deletion
programs (described in Section 10, “Designing and Writing an Agent”).
Access to ADMIN-MAIN You can call the ADMIN-MAIN screen from your application. The ADMIN-MAIN
interface is subject to change; refer to the latest Softdoc for syntax information.