Universal Broker spawns Universal Agent server components via external links that reside on the z/OS UNIX file system (USS). These links must point to names that match load modules installed into the SUNVLOAD load library.
UDM Manager also can spawn UCMD and USAP in response to an exec or execsap command, following the same external link approach used by Universal Broker. The Broker provides these links to UDM during registration.
If the Broker runs as UID 0 (or as a user with READ access to BPX.SUPERUSER), it will format and create each of these external links at start-up in the location specified by the TMP_DIRECTORY configuration option.
If the Broker does not run with superuser authority, each of these links must be created manually and their locations must be identified in the appropriate component definitions and configuration files.
To create external links for Universal Agent server components and have them recognized by Universal Broker:
Html bobswift |
<ul>
<li>
Panel |
---|
Html bobswift |
---|
<pre>
su
cd /tmp
ln -e UAGSRV ubroker.stc.uagsrv
ln -e UCMSRV ubroker.stc.ucmsrv
ln -e UCTSRV ubroker.stc.uctsrv
ln -e UDMSRV ubroker.stc.udmsrv
</pre> |
|
Html bobswift |
---|
|
The
directory
and
name
(for
example,
<code>ubrokerubroker.stc.
uagsrv</code>uagsrv
)
can
be
any
desired,
but
the
link
must
point
to
the
name
of
the
load
module
in
<code>&HLQ.UNV.
SUNVLOAD</code>.
<br><br>
If the SUNVLOAD
.
If the TMP_DIRECTORY
Html bobswift |
configuration option - defined inside <code> configuration option - defined inside &HLQ.UNV.UNVCONF(UBRCFG00)
</code> -
was
changed
from
its
default
value
of
<code>/
tmp</code>tmp
,
place
the
external
links
in
the
location
specified
by
the
mount
point
value.
<li> <code>UNVCOMP</code> <code>/tmp</code> with the configured -
/tmp
with the configured tmp_directory
<ul>
<li>UAGSRV: Set - UAGSRV: Set start_command
<code>uagsrv</code>
<li>UCMSRV <code>ucmsrv</code>
<li>UCTSRV <code>uctsrv</code>
<li>UDMSRV <code>udmsrv</code>
</ul>
</ul>To create external links used by UDM to execute UCMD and USAP, execute the following z/OS Unix commands
Panel |
---|
Html bobswift |
---|
<pre>
su
cd /tmp
ln -e UCMD ubroker.stc.ucmd
ln -e USAP ubroker.stc.usap
</pre> |
|
Update the UCMD_PATH and USAP_PATH Universal Broker configuration options in &HLQ.UNV.UNVCONF(UBRCFG00)
to point to the absolute path of those links.
If you expect to stop components from Universal Broker using UCTL, create a link for it as well (for example, In -e UCTL ubroker.stc.uctl) and update the UCTL_PATH option in &HLQ.UNV.UNVCONF(UBRCFG00)
.
If you expect to launch started tasks (STCs) via UCMD using a COMMAND_TYPE value of stc or via the UDM exec stc= command, execute the following z/OS Unix commands to create an external link to the UCMD Server STC Command Processor, UCMSCPST.
Panel |
---|
Html bobswift |
---|
<pre>
su
cd /tmp
ln -e UCMSCPST ucmd.stc
</pre> |
|
Update the UCMSCPST_PATH UCMD Server configuration option in &HLQ.UNV.UNVCONF(UCSCFG00)
to point to the absolute path of this new link.