C Gateway Terminology

C.1 Gateway Term Definitions

This section includes the following terms and definitions used in this edition of the Oracle Procedural Gateway for APPC Installation and Configuration Guide:

• Gateway Initialization File

• Gateway Remote Procedure

• tg4pwd

• pg4tcpmap tool

• PGA (Procedural Gateway Administration)

• PGDL (Procedural Gateway Definition Language)

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

• UTL_RAW PL/SQL Package (the UTL_RAW Functions)

• UTL_PG PL/SQL Package (the UTL_PG Functions)

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, 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 "RPC Functions" in this guide and to Appendix C, "Gateway RPC Interface" in the Oracle Procedural Gateway for APPC User's Guide 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 constituting 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 data type conversions.