C Gateway Terminology

C.1 Gateway Term Definitions

Following is a list of some of the terms and definitions used in this edition of the Oracle Procedural Gateway for APPC Installation and Configuration Guide.

Gateway Initialization File

This file is known as initsid.ora and it contains parameters that govern the operation of the gateway. If you are using the SNA protocol, then refer to Appendix A, "Gateway Initialization Parameters for SNA Protocol" for more information. Refer to Appendix B, "Gateway Initialization Parameters for TCP/IP Communication Protocol" if your protocol is TCP/IP.

Gateway Remote Procedure

The Oracle Procedural Gateway for APPC provides prebuilt remote procedures. In general, the following three remote procedures are used:

• PGAINIT, which initializes transactions

• PGAXFER, which transfers data

• PGATERM, which terminates transactions

Refer to "Remote Procedural Call Functions" in this guide and to Appendix C, "Gateway RPC Interface" in the Oracle Procedural Gateway for APPC User's Guide for Microsoft Windows for more information about gateway remote procedures.

tg4pwd

tg4pwd is a utility which encrypts passwords that are normally stored in the gateway initialization file. Passwords are stored in an encrypted form in the password file, making the information more secure. Refer to "Passwords in the Gateway Initialization File" for detailed information about how the tg4pwd utility works.

pg4tcpmap tool

This gateway mapping tool is applicable only when the gateway is using TCP/IP support for IMS Connect. Its function is to map the side profile name to TCP/IP and IMS Connect attributes into the PGA_TCP_IMSC table.

PGA

Procedural Gateway Administration (PGA) is a general reference within this guide to all or most components comprising the Oracle Procedural Gateway for APPC. This term is used when references to a specific product or component are too narrow.

PGDL

Procedural Gateway Definition Language (PGDL) is the collection of statements used to define transactions and data to the PGAU.

PL/SQL Stored Procedure Specification (PL/SQL package)

This is a precompiled PL/SQL procedure that is stored in Oracle Integrating Server.

UTL_RAW PL/SQL Package (the UTL_RAW Functions)

This component of the gateway represents a series of data conversion functions for PL/SQL RAW variables and remote host data. The types of conversions performed depend on the language of the remote host data. Refer to "UTL_RAW Functions" in Appendix D of the Oracle Procedural Gateway for APPC User's Guide for more information.

UTL_PG PL/SQL Package (the UTL_PG Functions)

This component of the gateway represents a series of COBOL numeric data conversion functions. Refer to "NUMBER_TO_RAW and RAW_TO_NUMBER Argument Values" in Appendix D of the Oracle Procedural Gateway for APPC User's Guide for supported numeric datatype conversions.