Signing a User-Supplied Exit in UNIX - Red Hat Linux 3 or Solaris 8

This section describes how to sign a user-supplied exit in UNIX.

If your company requires the additional functionality available via a user-supplied exit, you can create your own exit, and then sign that exit as your Optim™ exit. (See the Optim Initialization Exit Programmer's Guide for detailed information about how to write an exit.)

User-Supplied Exit Prerequisites

This section describes the user-supplied exit prerequisites.

Before you can sign a user-supplied exit, you must do the following:

  1. Compile your user-supplied exit and create a load library named libopmexit.so (in AIX®, Solaris, and Linux) or liboptmexit.sl (in HP-UX).
  2. Make sure that the OptimServer is not running; if it is, shut it down.
  3. Copy the file libopmexit.so or libopmexit.sl to the rt/bin directory, thereby overwriting the existing file, assuming one already exists.

Run the opmusign Script

This section describes how to run the opmusign script.

As part of setup, Optim places the script file, opmusign, in the rt/sbin directory. You can run the opmusign script at any time following setup to sign a user-supplied exit. (The letter “u” in the script name indicates it is used to sign a user-specified exit.)

The syntax for opmusign is as follows:

opmusign install_directory/rt [Company Id] [Name [Password] ]
install_directory/rt
The rt subdirectory appended to your installation directory
Company Id
The six-digit ID assigned to your company
Name
The Name assigned to your company
Password
The Password assigned to your company
  • These parameters are positional, so you must enter them in the preceding order.
  • The installation directory parameter (install_directory/rt) is required; the remaining parameters (ID, Name, and Password) are optional.
  • If you specify a Name, you also must specify the company ID.
  • If the company Name contains spaces, type the name in double quotation marks, such as “Sample Company”.
  • If you specify a Password, you also must specify the company ID and Name.

The following examples show three different ways of using the opmusign script to sign a user-supplied exit, following Optim installation. In all three examples, the path for the Optim installation directory is /users/roberts/rtinstalled.

opmusign Signing Example # 1

This section includes an example of signing a user-supplied exit.

Do the following to sign your user-supplied exit after installation:

  1. Shut down the Optim Server if it is running.
  2. Change to the /users/roberts/rtinstalled/rt directory. Notice the “rt” subdirectory appended to the installation directory; this is required.
  3. Run the opmusign script in the rt/sbin subdirectory and specify the present working directory. In the following example, the user specified the system variable `pwd` to indicate that /users/roberts/rtinstalled/rt is the present working directory. (The `pwd` variable has the same effect as specifying the directory's full path.)
    Signing a user-supplied exit with pwd variable
    Note: In the preceding example, the “pr0sign -s” parameter shown on the third line was generated by the signing script to indicate a user-supplied script is being signed.
  4. Type your company credentials when prompted for that information. Your company credentials consist of the company ID, Name, and Password assigned to your organization when you received Optim. All three entries are case-sensitive, and you must enter them in the format provided to you. Press Enter after each prompt to display the next prompt. After you specify your company Id, for example, press Enter to display the Name prompt.
    Signing a user-supplied exit - company credentials
    The Name assigned to your company may not match the spelling or punctuation used in your company's actual name.

opmusign Signing Example # 2

This section includes another example of signing a user-supplied exit.

As in Example # 1, shut down the Optim Server if it is running, and then specify the directories explicitly, as indicated on the first line of the following example.

Signing a user-supplied exit - specify directories explicitly

opmusign Signing Example # 3

This section includes another example of signing a user-supplied exit.

Do steps 1 and 2 in Example # 1 (that is, shut down the Optim Server if it is running and then change to the /users/roberts/rtinstalled/rt directory). Then run the opmusign script in the rt/sbin subdirectory, but specify all of the parameters explicitly, enclosing the company name in double quotation marks, as shown in the following example.

Signing a user-supplied exit - specify all parameters explicitly


Feedback