Pathway/iTS System Management Manual (G06.24+)

Configuring Pathway/iTS Objects
HP NonStop Pathway/iTS System Management Manual—426748-002
2-10
Configuring TCPs for a Customized TCP Object
Library
Configuring TCPs for a Customized TCP Object Library
You are allowed nine user conversion procedures for data passed between a SCREEN
COBOL program and a terminal screen or intelligent device. These procedures are
stored in the TCP user library object file, $SYSTEM.SYSTEM.PATHTCPL. For web
clients converted from SCREEN COBOL programs, these user conversion procedures
are run by the Pathway/iTS gateway process.
You can write your own user conversion procedures to replace those provided in the
standard TCP user library object file, and then customize the library object file to
include these procedures by using the nld program. A macro called MAKEUL
simplifies the task of building the customized object file. The HP NonStop Pathway/iTS
TCP and Terminal Programming Guide describes these tasks in detail.
You have two choices as to how you name the library object file:
•
You can name the customized library $SYSTEM.SYSTEM.PATHTCPL.
•
You can name the customized library file something other than
$SYSTEM.SYSTEM.PATHTCPL, such as $SKY.KING.USERTCPL.
If you keep the name $SYSTEM.SYSTEM.PATHTCPL for your customized library file,
you need not explicitly configure the library file name. If you use a different name, you
must use a SET TCP command with the GUARDIAN-LIB option to name the library
file:
= SET TCP GUARDIAN-LIB $SKY.KING.USERTCPL
To ensure that the proper user library object file is always used, use the SET TCP
command with the GUARDIAN-LIB option as part of your standard PATHMON
environment startup procedure,
Configuring TERM and PROGRAM Objects
Terminal objects represent tasks controlling the input-output devices and processes
that allow users to interact directly or programmatically with a Pathway application.
There are two types of these objects: configured terminal (TERM) objects and
temporary terminal (PROGRAM) objects.
Configured TERM objects are those you define and add to the PATHMON
configuration file. Temporary TERM objects are created for you (and automatically
deleted) by the PATHMON process in response to a RUN PROGRAM command,
using a template you configure as a PROGRAM object. The names you specify for
configured TERM objects must begin with a letter; the PATHMON process assigns
names beginning with numbers to temporary TERM objects.
Caution. Each time you install a new version of the TCP, you should add your customized
procedures to the new PATHTCPL object library file (be sure you name the new library file the
same name as the former, customized library file). Using the latest PATHTCPL object library
combined with your procedures ensures that there are no incompatibilities between the new
version of the TCP and the PATHTCPL object library.