This document guides you through the new installation of a BS2000 agent.
Various BS2000 versions require their own agent; a one-character code is assigned to each supported version. This code is part of the agent's file name. In this document, the specific code is replaced by the character "?."
The following guide describes how to install an agent in an AE system in which authentication is not used. Additional installation steps are required before the agent can be started and used if you intend to use one of the available authentication methods. For more information, see Advanced Security.
Requirements
- The User ID $UC4 in BS2000 must be set with approximately 10.000 PAM pages.
- The program BS2 TAR has been installed in BS2000. Unpack the TAR file from the supplied installation CD.
This might not be required when using BS2 TOOLS version 2.00W and later. BS2 TOOLS is used to receive files in a text archive and to unpack text archives.
Supplied Installation Files
The files are packed in TAR files. Each respective TAR file is stored in a subdirectory of IMAGE:AGENTS\BS2000, depending on the BS2000 variant. The file name indicates the current Automation Engine version. In the table shown below, the version is represented by the characters "x.xxx."
TAR files that contain "NK4" in their names are for NK4 pubsets and can also be unpacked using the BS2-TAR program.
| File name | Description | |
|---|---|---|
| x.xxx.UCX2?.LIB | Program Library | |
| Library Elements | ||
| UCXBB2?C | CallAPI Utility | |
| UCXEB2?U |
Utility for the console event (UCON connection) |
|
| UCXJB2? | Agent | |
| UCXJB2?M | Message program for BS2000 agent | |
| UCYBRFC? | Utility for RFC task | |
| x.xxx.UCXJB2?.INI | INI file for BS2000 agent | |
|
x.xxx.UCXEB2?U.INI |
INI file for the utility |
|
|
x.xxx.UCYEBXXZ |
Utility for recalling commands through a console (only for console events) |
|
|
x.xxx.E.UCXJB2? |
Sample - Enter file for BS2000 agent |
|
| x.xxx.E.UCXEB2?U | Sample - Enter file for the utility | |
|
x.xxx.UCX.MSL |
Message Library |
|
CalAPI files and their implementation are described in a separate document.
Potential Problems
- TSOS Rights
- K, NK
- PUBSET Right (Sysout)
- BCIN for establishing connection to the UC Server and to file transfer partners
Procedure
|
1. | Transferring TAR files to the host |
|---|
- Admin computer
- Transfer the TAR file UCXJB2?.TAR or UCXJB2?NK4.TAR via FTP in text mode.
- Alternately, the TAR file can be transferred with FTBS2000 or the EDT file transfer (also in text mode) to BS2000.
|
|
2. | Unpacking the TAR files and setting up the system environment |
|---|
- Host
- The TAR file can be unpacked in two ways:
- Unpacking with BS2 TAR:
/FILE UCXJB2?.TAR,LINK=TAR or /FILE UCXJB2?NK4.TAR,LINK=TAR
/EXEC BS2-TAR - Unpacking with BS2 TOOLS:
Show $UC4. Enter the command TAR into the command field next to the TAR file.
- The actual installation files are created. The TAR file can then be deleted.
- Remove the prefix from the installation files.
- Adjust the INI file and Enter job.
- Adjust HEADER.BS2000, TRAILER.BS2000 and RESTART.BS2000 if necessary. See: Job - Execution.
The file UCXJB2?M must be shareable, and the user ID and file name must correspond to the INI-file entry UC_EX_JOB_MD.
The UCYBRFC? file must be shareable if the RFC mechanism is activated.
|
|
3. | Starting the Agent |
|---|
- Server computer
- The AE system must be running.
- Host
- Start the agent under $TSOS.
Set priority and category.
An agent object is automatically created in system client 0000 and stored in the folder HOST. - Admin computer or Server computer
- Verify whether the agent is logged on.
- Start the UserInterface for client 0000. More detailed information about agents is provided in the System Overview. Because a newly logged-on agent has not yet been assigned a client, it can only be viewed in client 0000. The new agent can now be assigned to clients with the required rights using the Agent object.
|
|
4. | Shutting down the Agent |
|---|
- Host
- Quit the agent using the command /INTR Tsn, END or using the Task Manager of BS2 TOOLS.