Configuring the eLink Adapter for Portal Infranet


	Corporate Info \| News \| Solutions \| Products \| Partners \| Services \| Events \| Download \| How To Buy
	http://www.oracle.com/technology/documentation/index.html \| Search \| PDF Files \| Contact \|

eLink Adapter for Portal Infranet Doc Home \| eLink Adapter for Portal Infranet User Guide \| Previous Topic \| Next Topic \| Contents \|

This chapter consists of the following topics:

Adding the ELINKPORTALO Server to the UBBCONFIG File

The ELINKPORTALO server must be added to the UBBCONFIG file so that it is part of your eLink Platform system. To define this server, add ELINKPORTALO to the SERVERS section of the UBBCONFIG file. You must specify the CLOPT parameter to indicate the name of the configuration file that the adapter uses at run-time. The CLOPT parameter should be specified as:

CLOPT="-- -C elinkportal.cfg"

Listing 3-1 shows the syntax for the server definition in the UBBCONFIG file.

Listing 3-1 Syntax for ELINKPORTALO Server Definition in the UBBCONFIG File

*SERVERS

ELINKPORTALO
	SRVGRP=groupname			SRVID=n
	CLOPT="-- -C elinkportal.cfg"

For more information about the SRVGRP, SRVID, and CLOPT parameter syntax and definitions, refer to the BEA TUXEDO Reference Manual.

Listing 3-2 is a sample UBBCONFIG file. In this sample, the ELINKPORTALO server is defined in the SERVERS section with the required CLOPT option specified.

Listing 3-2 Sample UBBCONFIG File for Portal Infranet

*RESOURCES

IPCKEY		123791
DOMAINID		simpapp
MASTER		simple

*MACHINES

DAL1 
	LMID= simple
	TUXDIR= "/tuxedo"
	TUXCONFIG= "/myappdir/tuxconfig"
	APPDIR= "/myappdir"
	FIELDTBL = "sample.fml"
	FIELDTBL32= "sample.fml"
	FLDTBLDIR= "/myappdir"
	FLDTBLDIR32= "/myappdir"
	ULOGPFX= "/myappdir/ULOG"


*GROUPS

eLINK
         LMID=simple		 GRPNO=1

*SERVERS

DEFAULT:
       	CLOPT="-A"

ELINKPORTALO
	       SRVGRP=eLINK			SRVID=10
	       CLOPT="-- -C elinkportal.cfg"


*SERVICES

*ROUTING

Modifying the Adapter Configuration File

The elink Adapter for Portal Infranet reads a configuration file at startup to advertise services that retrieve or update data maintained by the Portal Infranet System. This configuration file contains ASCII text that describes the services that are to be advertised and what these services manipulate within Portal Infranet. The name of the configuration file is arbitrarily chosen by the user, but it must match what is specified in the UBBCONFIG file (as described in the Adding the ELINKPORTALO Server to the UBBCONFIG File section of this guide). This configuration file must be located in the application directory (APPDIR) of the end-user's application.

The adapter configuration file contains three different types of sections. Each section defines specific configuration parameters. The SERVER section defines the global flags that manipulate the operation of the adapter. SERVICE sections define each service that is advertised by the adapter. FIELD_GROUP sections define groups of fields that are input or output of a specified service. Each section is begins with by a text label prefixed with an asterisk (e.g. *SERVICE).

The only part of the configuration file that should be modified is the SERVER section. The definitions in the provided sample configuration file define services for account management and billing via Portal Infranet. These definitions do not need to be modified unless you wish to change the name of the advertised service. Nevertheless, all configuration sections and parameters are described below.

The SERVER Section

In this section you can specify NAME, EXIT_CONNECT_LOSS, MINMSGLEVEL, and MAXMSGLEVEL parameters. The following table provides descriptions for these parameters.

Service Name
Description

NAME = < Name >

A unique identifier for a specific instance of the eLink Adapter for Portal Infranet. This value should be alphanumeric text.

EXIT_CONNECT_LOSS =
< Y/N >

Specifies whether the eLink Adapter for Portal Infranet should exit if the connection with Portal Infranet is lost.

MINMSGLEVEL and MAXMSGLEVEL

Specifies that the adapter should log additional diagnostic information in order to troubleshoot problems. The two parameters are used to specify a range of trace messages to be logged. The range 1 to 9 specifies that all diagnostic messages should be logged.

Service Name	Description
NAME = < Name >	A unique identifier for a specific instance of the eLink Adapter for Portal Infranet. This value should be alphanumeric text.
EXIT_CONNECT_LOSS = < Y/N >	Specifies whether the eLink Adapter for Portal Infranet should exit if the connection with Portal Infranet is lost.
MINMSGLEVEL and MAXMSGLEVEL	Specifies that the adapter should log additional diagnostic information in order to troubleshoot problems. The two parameters are used to specify a range of trace messages to be logged. The range 1 to 9 specifies that all diagnostic messages should be logged.

The SERVICE Section

For each service that is to be advertised by the adapter, a SERVICE section defines service functionality within Portal Infranet. Each SERVICE section defines the NAME of the service to be advertised, the OPERATION to be performed in the Portal Infranet system, the PORTAL_OPCODE to be executed, and the INPUT_MESSAGE and OUTPUT_MESSAGE of the service.

Service Name
Description

NAME =
< Name >

The name of the eLink Platform service to be advertised by the adapter.

OPERATION =
< CREATE / MODIFY / DELETE / GET >

The operation that is to be performed within the Portal Infranet database. For example a service that creates a customer would be defined with an OPERATION of CREATE.

PORTAL_OPCODE = PCM_OP_xxx

The Portal Infranet PCM_OP() code that is to be executed by this service. See Portal's Programmer's Guide for a list of valid Portal Infranet PCM_OP() codes.

INPUT_MESSAGE =
< Field Group Name >

The input message expected by this service is further defined in a FIELD_GROUP section. The name of this FIELD_GROUP is specified in the INPUT_MESSAGE parameter.

OUTPUT_MESSAGE = < Field Group Name >

The output message returned by this service is further defined in a FIELD_GROUP section. The name of this FIELD_GROUP is specified in the OUTPUT_MESSAGE parameter.

Service Name	Description
NAME = < Name >	The name of the eLink Platform service to be advertised by the adapter.
OPERATION = < CREATE / MODIFY / DELETE / GET >	The operation that is to be performed within the Portal Infranet database. For example a service that creates a customer would be defined with an OPERATION of CREATE.
PORTAL_OPCODE = PCM_OP_xxx	The Portal Infranet PCM_OP() code that is to be executed by this service. See Portal's Programmer's Guide for a list of valid Portal Infranet PCM_OP() codes.
INPUT_MESSAGE = < Field Group Name >	The input message expected by this service is further defined in a FIELD_GROUP section. The name of this FIELD_GROUP is specified in the INPUT_MESSAGE parameter.
OUTPUT_MESSAGE = < Field Group Name >	The output message returned by this service is further defined in a FIELD_GROUP section. The name of this FIELD_GROUP is specified in the OUTPUT_MESSAGE parameter.

The FIELD_GROUP Section

A FIELD_GROUP defines the fields that make up a request or response message of a service. A FIELD_GROUP lists the fields and subgroups of fields that are to be sent or received from Portal Infranet. A FIELD_GROUP definition may reference another FIELD_GROUP definition in order to define a sub-group hierarchy.

Service Name
Description

NAME = < Name >

The unique name of the FIELD_GROUP. This name may be referenced in the INPUT_MESSAGE or OUTPUT_MESSAGE parameters of a SERVICE definition, or may be referenced in another FIELD_GROUP definition.

FLIST_NAME=
< FLIST Name >

The name of the FLIST that is to be created when this FIELD_GROUP is translated to a Portal Infranet FLIST data structure.

OCCRANCE_FIELD=
< Field Name >

The name of the field that explicitly denotes how many occurrences of this FIELD_GROUP exist in a given message. See Chapter 4 on Hierarchical Data.

FIELDS=
< Field Name, Field Name, >

List of names of the FML fields (without the FLD_ prefix) that make up this FIELD_GROUP. FIELD_GROUP names may also be referenced in the FIELDS list.

Service Name	Description
NAME = < Name >	The unique name of the FIELD_GROUP. This name may be referenced in the INPUT_MESSAGE or OUTPUT_MESSAGE parameters of a SERVICE definition, or may be referenced in another FIELD_GROUP definition.
FLIST_NAME= < FLIST Name >	The name of the FLIST that is to be created when this FIELD_GROUP is translated to a Portal Infranet FLIST data structure.
OCCRANCE_FIELD= < Field Name >	The name of the field that explicitly denotes how many occurrences of this FIELD_GROUP exist in a given message. See Chapter 4 on Hierarchical Data.
FIELDS= < Field Name, Field Name, >	List of names of the FML fields (without the FLD_ prefix) that make up this FIELD_GROUP. FIELD_GROUP names may also be referenced in the FIELDS list.

Listing 3-3 shows an example of the adapter configuration file that is provided with the Portal Infranet Adapter. The concepts discussed above are illustrated in this file.

Listing 3-3 The Adapter Configuration File

*SERVER
NAME=PORTAL_ADAPTER
EXIT_CONNECT_LOSS=Y
MINMSGLEVEL=1 
MAXMSGLEVEL=9

*SERVICE
NAME=CREATE_CUST
OPERATION=CREATE
INPUT_MESSAGE=ACCOUNT_INPUT
OUTPUT_MESSAGE=ACCOUNT_OUTPUT

*SERVICE
NAME=DEL_PRODUCT
OPERATION=DELETE
INPUT_MESSAGE=DELPROD_INPUT
OUTPUT_MESSAGE=DELPROD_OUTPUT

*SERVICE
NAME=MOD_PAY_INFO
OPERATION=MODIFY
INPUT_MESSAGE=MODPAYINFO_INPUT
OUTPUT_MESSAGE=MODPAYINFO_OUTPUT

*SERVICE
NAME=MOD_BILL_INFO
OPERATION=MODIFY
INPUT_MESSAGE=MODBILLINFO_INPUT
OUTPUT_MESSAGE=MODBILLINFO_OUTPUT

*SERVICE
NAME=MOD_CRED_BAL
OPERATION=MODIFY
INPUT_MESSAGE=MODCREDBAL_INPUT
OUTPUT_MESSAGE=MODCREDBAL_OUTPUT

*SERVICE
NAME=MOD_ACC_INFO
OPERATION=MODIFY
INPUT_MESSAGE=MODACCINFO_INPUT
OUTPUT_MESSAGE=MODACCINFO_OUTPUT

*SERVICE
NAME=MOD_LOC_INFO
OPERATION=MODIFY
INPUT_MESSAGE=MODLOCINFO_INPUT
OUTPUT_MESSAGE=MODLOCINFO_OUTPUT

*SERVICE
NAME=MOD_CON_INFO
OPERATION=MODIFY
INPUT_MESSAGE=MODCONINFO_INPUT
OUTPUT_MESSAGE=MODCONINFO_OUTPUT

*SERVICE
NAME=ADD_CONTACT
OPERATION=MODIFY
INPUT_MESSAGE=ADDCON_INPUT
OUTPUT_MESSAGE=ADDCON_OUTPUT

*SERVICE
NAME=MOD_ACC_STAT
OPERATION=MODIFY
INPUT_MESSAGE=MODACCSTAT_INPUT
OUTPUT_MESSAGE=MODACCSTAT_OUTPUT


*SERVICE
NAME=ADD_DEAL
OPERATION=MODIFY
INPUT_MESSAGE=ADDDEAL_INPUT
OUTPUT_MESSAGE=ADDDEAL_OUTPUT

*SERVICE
NAME=MOD_PRODUCT
OPERATION=MODIFY
INPUT_MESSAGE=MODPROD_INPUT
OUTPUT_MESSAGE=MODPROD_OUTPUT


*SERVICE
NAME=ADD_SERVICE
OPERATION=MODIFY
INPUT_MESSAGE=ADDSERV_INPUT
OUTPUT_MESSAGE=ADDSERV_OUTPUT


*SERVICE
NAME=MOD_PROD_STAT
OPERATION=MODIFY
INPUT_MESSAGE=MODPRODSTAT_INPUT
OUTPUT_MESSAGE=MODPRODSTAT_OUTPUT


*SERVICE
NAME=MOD_SERV_LOG
OPERATION=MODIFY
INPUT_MESSAGE=MODSERVLOG_INPUT
OUTPUT_MESSAGE=MODSERVLOG_OUTPUT

*SERVICE
NAME=MOD_SERV_PASS
OPERATION=MODIFY
INPUT_MESSAGE=MODSERVPASS_INPUT
OUTPUT_MESSAGE=MODSERVPASS_OUTPUT

*SERVICE
NAME=MOD_SERV_STAT
OPERATION=MODIFY
INPUT_MESSAGE=MODSERVSTAT_INPUT
OUTPUT_MESSAGE=MODSERVSTAT_OUTPUT

*SERVICE
NAME=GET_BILL_LIST
OPERATION=GET
INPUT_MESSAGE=GETBILLLIST_INPUT
OUTPUT_MESSAGE=GETBILLLIST_OUTPUT

*SERVICE
NAME=GET_LINE_ITEMS
OPERATION=GET
INPUT_MESSAGE=GETLINEITEMS_INPUT
OUTPUT_MESSAGE=GETLINEITEMS_OUTPUT

*SERVICE
NAME=GET_INVO_IMG
OPERATION=GET
INPUT_MESSAGE=GETINVOIMG_INPUT
OUTPUT_MESSAGE=GETINVOIMG_OUTPUT

*SERVICE
NAME=GET_ACC_INFO
OPERATION=GET
INPUT_MESSAGE=GETACCINFO_INPUT
OUTPUT_MESSAGE=GETACCINFO_OUTPUT

*SERVICE
NAME=GET_PROD_INFO
OPERATION=GET
INPUT_MESSAGE=GETPRODINFO_INPUT
OUTPUT_MESSAGE=GETPRODINFO_OUTPUT

*SERVICE
NAME=GET_RATE_INFO
OPERATION=GET
INPUT_MESSAGE=GETRATEINFO_INPUT
OUTPUT_MESSAGE=GETRATEINFO_OUTPUT

*SERVICE
NAME=GET_AUTH
OPERATION=GET
INPUT_MESSAGE=GETAUTHINFO_INPUT
OUTPUT_MESSAGE=GETAUTHINFO_OUTPUT

*SERVICE
NAME=GET_ACCOUNT_NO
OPERATION=GET
INPUT_MESSAGE=GET_ACCOUNT_NO_INPUT
OUTPUT_MESSAGE=GET_ACCOUNT_NO_OUTPUT

*SERVICE
NAME=POST_ACTIVITY
OPERATION=MODIFY
INPUT_MESSAGE=POST_ACTIVITY_INPUT
OUTPUT_MESSAGE=POST_ACTIVITY_OUTPUT

*SERVICE
NAME=LOGIN
OPERATION=MODIFY
INPUT_MESSAGE=LOGIN_INPUT
OUTPUT_MESSAGE=LOGIN_OUTPUT

*SERVICE
NAME=LOGOUT
OPERATION=MODIFY
INPUT_MESSAGE=LOGOUT_INPUT
OUTPUT_MESSAGE=LOGOUT_OUTPUT

*SERVICE
NAME=GET_SESSIONS
OPERATION=MODIFY
INPUT_MESSAGE=GET_SESSIONS_INPUT
OUTPUT_MESSAGE=GET_SESSIONS_OUTPUT

*SERVICE
NAME=DEL_CUST
OPERATION=DELETE
INPUT_MESSAGE=DEL_CUST_INPUT
OUTPUT_MESSAGE=DEL_CUST_OUTPUT

*FIELD_GROUP
NAME=ACCOUNT_INPUT
FLIST_NAME=ACCOUNT_INPUT
OCCRANCE_FLD=ACCOUNT_INFO_OCC
FIELDS=NAME,SERVICES,BILLINFO,ACTGINFO,PAYINFO,NAMEINFO,EXEMPTIONS,LOCALES

*FIELD_GROUP
NAME=ACCOUNT_OUTPUT
FLIST_NAME=ACCOUNT_OUTPUT
OCCRANCE_FLD=ACCOUNT_INFO_OCC
FIELDS=OPS_ERROR,DESCR,ACCOUNT_NO,SERVICES,BILLINFO,ACTGINFO,PAYINFO,NAMEINFO,EXEMPTIONS,LOCALES

*FIELD_GROUP
NAME=DELPROD_INPUT
FLIST_NAME=DELPROD_INPUT
OCCRANCE_FLD=DELPROD_INFO_OCC
FIELDS=ACCOUNT_NO,PROD_NAME,ELEMENT_ID,QUANTITY
 
*FIELD_GROUP
NAME=DELPROD_OUTPUT
FLIST_NAME=DELPROD_OUTPUT
OCCRANCE_FLD=DELPROD_INFO_OCC
FIELDS=OPS_ERROR,DESCR

*FIELD_GROUP
NAME=MODPAYINFO_INPUT
FLIST_NAME=MODPAYINFO_INPUT
OCCRANCE_FLD=MODPAYINFO_INFO_OCC
FIELDS=ACCOUNT_NO,PAYINFO

*FIELD_GROUP
NAME=MODPAYINFO_OUTPUT
FLIST_NAME=MODPAYINFO_OUTPUT
OCCRANCE_FLD=MODPAYINFO_INFO_OCC
FIELDS=OPS_ERROR,DESCR

*FIELD_GROUP
NAME=MODBILLINFO_INPUT
FLIST_NAME=MODBILLINFO_INPUT
OCCRANCE_FLD=MODBILLINFO_INFO_OCC
FIELDS=ACCOUNT_NO,BILLINFO_2

*FIELD_GROUP
NAME=MODBILLINFO_OUTPUT
FLIST_NAME=MODBILLINFO_OUTPUT
OCCRANCE_FLD=MODBILLINFO_INFO_OCC
FIELDS=OPS_ERROR,DESCR

*FIELD_GROUP
NAME=MODCREDBAL_INPUT
FLIST_NAME=MODCREDBAL_INPUT
OCCRANCE_FLD=MODCREDBAL_INFO_OCC
FIELDS=ACCOUNT_NO,LIMIT

*FIELD_GROUP
NAME=MODCREDBAL_OUTPUT
FLIST_NAME=MODCREDBAL_OUTPUT
OCCRANCE_FLD=MODBILLINFO_INFO_OCC
FIELDS=OPS_ERROR,DESCR

*FIELD_GROUP
NAME=MODACCINFO_INPUT
FLIST_NAME=MODACCINFO_INPUT
OCCRANCE_FLD=MODACCINFO_INFO_OCC
FIELDS=ACCOUNT_NO,ACTGINFO

*FIELD_GROUP
NAME=MODACCINFO_OUTPUT
FLIST_NAME=MODACCINFO_OUTPUT
OCCRANCE_FLD=MODACCINFO_INFO_OCC
FIELDS=OPS_ERROR,DESCR


*FIELD_GROUP
NAME=MODLOCINFO_INPUT
FLIST_NAME=MODLOCINFO_INPUT
OCCRANCE_FLD=MODLOCINFO_INFO_OCC
FIELDS=ACCOUNT_NO,LOCALES

*FIELD_GROUP
NAME=MODLOCINFO_OUTPUT
FLIST_NAME=MODLOCINFO_OUTPUT
OCCRANCE_FLD=MODLOCINFO_INFO_OCC
FIELDS=OPS_ERROR,DESCR

*FIELD_GROUP
NAME=MODCONINFO_INPUT
FLIST_NAME=MODCONINFO_INPUT
OCCRANCE_FLD=MODCONINFO_INFO_OCC
FIELDS=ACCOUNT_NO,NAMEINFO

*FIELD_GROUP
NAME=MODCONINFO_OUTPUT
FLIST_NAME=MODCONINFO_OUTPUT
OCCRANCE_FLD=MODCONINFO_INFO_OCC
FIELDS=OPS_ERROR,DESCR

*FIELD_GROUP
NAME=ADDCON_INPUT
FLIST_NAME=ADDCON_INPUT
OCCRANCE_FLD=ADDCON_INFO_OCC
FIELDS=ACCOUNT_NO,NAMEINFO

*FIELD_GROUP
NAME=ADDCON_OUTPUT
FLIST_NAME=ADDCON_OUTPUT
OCCRANCE_FLD=ADDCON_INFO_OCC
FIELDS=OPS_ERROR,DESCR

*FIELD_GROUP
NAME=MODACCSTAT_INPUT
FLIST_NAME=MODACCSTAT_INPUT
OCCRANCE_FLD=MODACCSTAT_INFO_OCC
FIELDS=ACCOUNT_NO,DESCR,STATUS,STATUS_FLAGS,CLOSE_WHEN_T

*FIELD_GROUP
NAME=MODACCSTAT_OUTPUT
FLIST_NAME=MODACCSTAT_OUTPUT
OCCRANCE_FLD=MODACCSTAT_INFO_OCC
FIELDS=OPS_ERROR,DESCR

*FIELD_GROUP
NAME=ADDDEAL_INPUT
FLIST_NAME=ADDDEAL_INPUT
OCCRANCE_FLD=ADDDEAL_INFO_OCC
FIELDS=ACCOUNT_NO,DEAL_NAME

*FIELD_GROUP
NAME=ADDDEAL_OUTPUT
FLIST_NAME=ADDDEAL_OUTPUT
OCCRANCE_FLD=ADDDEAL_INFO_OCC
FIELDS=OPS_ERROR,DESCR


*FIELD_GROUP
NAME=MODPROD_INPUT
FLIST_NAME=MODPROD_INPUT
OCCRANCE_FLD=MODPROD_INFO_OCC
FIELDS=ACCOUNT_NO,PURCHASE_DISCOUNT,USAGE_DISCOUNT,PURCHASE_START_T,PURCHASE_END_T,USAGE_START_T,USAGE_END_T,ELEMENT_ID,PROD_NAME

*FIELD_GROUP
NAME=MODPROD_OUTPUT
FLIST_NAME=MODPROD_OUTPUT
OCCRANCE_FLD=MODPROD_INFO_OCC
FIELDS=OPS_ERROR,DESCR

*FIELD_GROUP
NAME=ADDSERV_INPUT
FLIST_NAME=ADDSERV_INPUT
OCCRANCE_FLD=ADDSERV_INFO_OCC
FIELDS=ACCOUNT_NO,NAME,SERVICES

*FIELD_GROUP
NAME=ADDSERV_OUTPUT
FLIST_NAME=ADDSERV_OUTPUT
OCCRANCE_FLD=ADDSERV_INFO_OCC
FIELDS=OPS_ERROR,DESCR

*FIELD_GROUP
NAME=MODPRODSTAT_INPUT
FLIST_NAME=MODPRODSTAT_INPUT
OCCRANCE_FLD=MODPRODSTAT_INFO_OCC
FIELDS=ACCOUNT_NO,STATUS,PROD_NAME,ELEMENT_ID,STATUS_FLAGS

*FIELD_GROUP
NAME=MODPRODSTAT_OUTPUT
FLIST_NAME=MODPRODSTAT_OUTPUT
OCCRANCE_FLD=MODPRODSTAT_INFO_OCC
FIELDS=OPS_ERROR,DESCR

*FIELD_GROUP
NAME=MODSERVLOG_INPUT
FLIST_NAME=MODSERVLOG_INPUT
OCCRANCE_FLD=MODSERVLOG_INFO_OCC
FIELDS=ACCOUNT_NO,SERVICE_TYPE,LOGIN,NAME

*FIELD_GROUP
NAME=MODSERVLOG_OUTPUT
FLIST_NAME=MODSERVLOG_OUTPUT
OCCRANCE_FLD=MODSERVLOG_INFO_OCC
FIELDS=OPS_ERROR,DESCR

*FIELD_GROUP
NAME=MODSERVPASS_INPUT
FLIST_NAME=MODSERVPASS_INPUT
OCCRANCE_FLD=MODSERVPASS_INFO_OCC
FIELDS=ACCOUNT_NO,SERVICE_TYPE,LOGIN,PASSWD_CLEAR

*FIELD_GROUP
NAME=MODSERVPASS_OUTPUT
FLIST_NAME=MODSERVPASS_OUTPUT
OCCRANCE_FLD=MODSERVPASS_INFO_OCC
FIELDS=OPS_ERROR,DESCR

*FIELD_GROUP
NAME=MODSERVSTAT_INPUT
FLIST_NAME=MODSERVSTAT_INPUT
OCCRANCE_FLD=MODSERVSTAT_INFO_OCC
FIELDS=ACCOUNT_NO,SERVICE_TYPE,LOGIN,DESCR,STATUS,STATUS_FLAGS,CLOSE_WHEN_T

*FIELD_GROUP
NAME=MODSERVSTAT_OUTPUT
FLIST_NAME=MODSERVSTAT_OUTPUT
OCCRANCE_FLD=MODSERVSTAT_INFO_OCC
FIELDS=OPS_ERROR,DESCR

*FIELD_GROUP
NAME=GETBILLLIST_INPUT
FLIST_NAME=GETBILLLIST_INPUT
OCCRANCE_FLD=GETBILLLIST_INFO_OCC
FIELDS=ACCOUNT_NO

*FIELD_GROUP
NAME=GETBILLLIST_OUTPUT
FLIST_NAME=GETBILLLIST_OUTPUT
OCCRANCE_FLD=GETBILLLIST_INFO_OCC
FIELDS=OPS_ERROR,DESCR,ACCOUNT_NO,BILLS_1

*FIELD_GROUP
NAME=GETLINEITEMS_INPUT
FLIST_NAME=GETLINEITEMS_INPUT
OCCRANCE_FLD=GETLINEITEMS_INFO_OCC
FIELDS=ACCOUNT_NO,BILLS

*FIELD_GROUP
NAME=GETLINEITEMS_OUTPUT
FLIST_NAME=GETLINEITEMS_OUTPUT
OCCRANCE_FLD=GETLINEITEMS_INFO_OCC
FIELDS=OPS_ERROR,DESCR,ACCOUNT_NO,BILL_NO,ITEMS

*FIELD_GROUP
NAME=GETINVOIMG_INPUT
FLIST_NAME=GETINVOIMG_INPUT
OCCRANCE_FLD=GETINVOIMG_INFO_OCC
FIELDS=ACCOUNT_NO,BILLS_2

*FIELD_GROUP
NAME=GETINVOIMG_OUTPUT
FLIST_NAME=GETINVOIMG_OUTPUT
OCCRANCE_FLD=GETINVOIMG_INFO_OCC
FIELDS=OPS_ERROR,DESCR,ACCOUNT_NO,BILLS_3

*FIELD_GROUP
NAME=GETACCINFO_INPUT
FLIST_NAME=GETACCINFO_INPUT
OCCRANCE_FLD=GETACCINFO_INFO_OCC
FIELDS=ACCOUNT_NO

*FIELD_GROUP
NAME=GETACCINFO_OUTPUT
FLIST_NAME=GETACCINFO_OUTPUT
OCCRANCE_FLD=GETACCINFO_INFO_OCC
FIELDS=OPS_ERROR,DESCR,ACCOUNT_NO,BALANCES,PRODUCTS,EXEMPTIONS,LOCALES,SERVICES_1,BILLINFO_1,ACTGINFO_1,PAYINFO,NAMEINFO

*FIELD_GROUP
NAME=GETPRODINFO_INPUT
FLIST_NAME=GETPRODINFO_INPUT
OCCRANCE_FLD=GETPRODINFO_INFO_OCC
FIELDS=ACCOUNT_NO

*FIELD_GROUP
NAME=GETPRODINFO_OUTPUT
FLIST_NAME=GETPRODINFO_OUTPUT
OCCRANCE_FLD=GETPRODINFO_INFO_OCC
FIELDS=OPS_ERROR,DESCR,PRODUCTS_1

*FIELD_GROUP
NAME=GETRATEINFO_INPUT
FLIST_NAME=GETRATEINFO_INPUT
OCCRANCE_FLD=GETRATEINFO_INFO_OCC
FIELDS=ACCOUNT_NO,PROD_NAME,ELEMENT_ID

*FIELD_GROUP
NAME=GETRATEINFO_OUTPUT
FLIST_NAME=GETRATEINFO_OUTPUT
OCCRANCE_FLD=GETRATEINFO_INFO_OCC
FIELDS=OPS_ERROR,DESCR,RATES

*FIELD_GROUP
NAME=SERVICES
FLIST_NAME=SERVICES
OCCRANCE_FLD=SERVICES_INFO_OCC
FIELDS=DEAL_NAME,SERVICE_TYPE,LOGIN,PASSWD_CLEAR

*FIELD_GROUP
NAME=SERVICES_1
FLIST_NAME=SERVICES
OCCRANCE_FLD=SERVICES_INFO_OCC
FIELDS=LASTSTAT_CMNT,LAST_STATUS_T,STATUS_FLAGS,STATUS,LOGIN,PASSWD

*FIELD_GROUP
NAME=BILLINFO
FLIST_NAME=BILLINFO
OCCRANCE_FLD=BILLINFO_INFO_OCC
FIELDS=MERCHANT,BILL_MODE,BILL_TYPE,CURRENCY,BILL_WHEN,ACCESS_CODE1,ACCESS_CODE2

*FIELD_GROUP
NAME=BILLINFO_1
FLIST_NAME=BILLINFO
OCCRANCE_FLD=BILLINFO_INFO_OCC
FIELDS=MERCHANT,BILL_MODE,BILL_TYPE,CURRENCY,BILL_WHEN,ACCESS_CODE1,ACCESS_CODE2,LAST_BILL_T,NEXT_BILL_T

*FIELD_GROUP
NAME=BILLINFO_2
FLIST_NAME=BILLINFO
OCCRANCE_FLD=BILLINFO_INFO_OCC
FIELDS=BILL_TYPE,CURRENCY,BILL_WHEN,ACCESS_CODE1,ACCESS_CODE2

*FIELD_GROUP
NAME=ACTGINFO
FLIST_NAME=ACTGINFO
OCCRANCE_FLD=ACTGINFO_INFO_OCC
FIELDS=ACTG_FUTURE_DOM,ACTG_TYPE

*FIELD_GROUP
NAME=ACTGINFO_1
FLIST_NAME=ACTGINFO
OCCRANCE_FLD=ACTGINFO_INFO_OCC
FIELDS=ACTG_CYCLE_DOM,ACTG_TYPE

*FIELD_GROUP
NAME=PAYINFO
FLIST_NAME=PAYINFO
OCCRANCE_FLD=PAYINFO_INFO_OCC
FIELDS=NAME,OBJ_TYPE,INV_INFO,CC_INFO

*FIELD_GROUP
NAME=INV_INFO
FLIST_NAME=INV_INFO
OCCRANCE_FLD=INV_INFO_OCC
FIELDS=NAME,ADDRESS,CITY,STATE,ZIP,COUNTRY,EMAIL_ADDR,DELIVERY_PREFER,DELIVERY_DESCR,INV_TERMS,INV_INSTR,PO_TYPE,PO_OPTIONS,PO_AMOUNT,PO_BAL_THRESHOLD,PO_EXP,PO_EXP_THRESHOLD,PO_ORDER_NO,PO_TERMS

*FIELD_GROUP
NAME=CC_INFO
FLIST_NAME=CC_INFO
OCCRANCE_FLD=CC_INFO_OCC
FIELDS=NAME,ADDRESS,CITY,STATE,ZIP,COUNTRY,DEBIT_NUM,DEBIT_EXP

*FIELD_GROUP
NAME=NAMEINFO
FLIST_NAME=NAMEINFO
OCCRANCE_FLD=NAMEINFO_INFO_OCC
FIELDS=ELEMENT_ID,CONTACT_TYPE,SALUTATION,LAST_NAME,FIRST_NAME,MIDDLE_NAME,TITLE,COMPANY,ADDRESS,CITY,STATE,ZIP,COUNTRY,EMAIL_ADDR,PHONES

*FIELD_GROUP
NAME=PHONES
FLIST_NAME=PHONES
OCCRANCE_FLD=PHONES_INFO_OCC
FIELDS=TYPE,PHONE

*FIELD_GROUP
NAME=EXEMPTIONS
FLIST_NAME=EXEMPTIONS
OCCRANCE_FLD=EXEMPTIONS_INFO_OCC
FIELDS=TYPE,PERCENT

*FIELD_GROUP
NAME=LOCALES
FLIST_NAME=LOCALES
OCCRANCE_FLD=LOCALE_INFO_OCC
FIELDS=LOCALE

*FIELD_GROUP
NAME=BALANCES
FLIST_NAME=BALANCES
OCCRANCE_FLD=BALANCES_INFO_OCC>
FIELDS=ELEMENT_ID,CREDIT_FLOOR,CREDIT_LIMIT,CREDIT_THRESHOLDS,CURRENT_BAL,FLAGS,OPEN_BAL

*FIELD_GROUP
NAME=PRODUCTS
FLIST_NAME=PRODUCTS
OCCRANCE_FLD=PRODUCTS_INFO_OCC
FIELDS=ELEMENT_ID,CREATED_T,CYCLE_DISCOUNT,CYCLE_DISC_AMT,CYCLE_END_T,CYCLE_START_T,FLAGS,MMC_END_T,MMC_START_T,MMC_TYPE,PURCHASE_DISCOUNT,PURCHASE_DISC_AMT,PURCHASE_END_T,PURCHASE_START_T,SERVICE_TYPE,LOGIN,PASSWD

*FIELD_GROUP
NAME=PRODUCTS_1
FLIST_NAME=PRODUCTS
OCCRANCE_FLD=PRODUCTS_INFO_OCC
FIELDS=ELEMENT_ID,NAME,DESCR,STATUS,CREATED_T,MOD_T,END_T,OWN_MAX,OWN_MIN,PARTIAL,PERMITTED,PROVISIONING_TAG,PURCHASE_MAX,PURCHASE_MIN,START_T,TYPE,STATUS

*FIELD_GROUP
NAME=BILLS
FLIST_NAME=BILLS
OCCRANCE_FLD=BILLS_INFO_OCC
FIELDS=BILL_NO,START_T,END_T,STATUS

*FIELD_GROUP
NAME=BILLS_1
FLIST_NAME=BILLS
OCCRANCE_FLD=BILLS_INFO_OCC
FIELDS=BILL_NO,START_T,END_T,TOTAL_DUE,CURRENT_TOTAL,CURRENCY

*FIELD_GROUP
NAME=BILLS_2
FLIST_NAME=BILLS
OCCRANCE_FLD=BILLS_INFO_OCC
FIELDS=BILL_NO

*FIELD_GROUP
NAME=BILLS_3
FLIST_NAME=BILLS
OCCRANCE_FLD=BILLS_INFO_OCC
FIELDS=BILL_NO,BUFFER

*FIELD_GROUP
NAME=ITEMS
FLIST_NAME=ITEMS
OCCRANCE_FLD=ITEMS_INFO_OCC
FIELDS=ITEM_NO,NAME,ITEM_TOTAL,CURRENCY,DISPUTED,RECVD,ADJUSTED,DUE,STATUS

*FIELD_GROUP
NAME=LIMIT
FLIST_NAME=LIMIT
OCCRANCE_FLD=LIMIT_INFO_OCC
FIELDS=ELEMENT_ID,CREDIT_LIMIT,CREDIT_FLOOR,CREDIT_THRESHOLDS

*FIELD_GROUP
NAME=RATES
FLIST_NAME=RATES
OCCRANCE_FLD=RATES_INFO_OCC
FIELDS=CURRENCY,DESCR,CREATED_T,END_T,MOD_T,NAME,PRIORITY,PRORATE_FIRST,PRORATE_LAST,PURCHASE_MAX,PURCHASE_MIN,RELATIVE_END_T,RELATIVE_START_T,VALID_DOM,VALID_DOW,VALID_MOY,TAX_CODE,TAX_WHEN,TYPE,ZONE,BAL_IMPACTS

*FIELD_GROUP
NAME=BAL_IMPACTS
FLIST_NAME=BAL_IMPACTS
OCCRANCE_FLD=BAL_IMPACTS_INFO_OCC
FIELDS=ELEMENT_ID,FIXED_OPERAND,FLAGS,FREE_QUANTITY,GL_ID,IMPACT_CATEGORY,SCALED_OPERAND

*FIELD_GROUP
NAME=GETAUTHINFO_INPUT
FLIST_NAME=GETAUTHINFO_INPUT
OCCRANCE_FLD=GETAUTHINFO_OCC
FIELDS=SERVICE_TYPE,LOGIN,PASSWD_CLEAR

*FIELD_GROUP
NAME=GETAUTHINFO_OUTPUT
FLIST_NAME=GETAUTHINFO_OUTPUT
OCCRANCE_FLD=GETAUTHINFO_OCC
FIELDS=RESULT,TYPE,DESCR

*FIELD_GROUP
NAME=GET_ACCOUNT_NO_INPUT
FLIST_NAME=GET_ACCOUNT_NO_INPUT
OCCRANCE_FLD=GET_ACCOUNT_NO_OCC
FIELDS=SERVICE_TYPE,LOGIN

*FIELD_GROUP
NAME=GET_ACCOUNT_NO_OUTPUT
FLIST_NAME=GET_ACCOUNT_NO_OUTPUT
OCCRANCE_FLD=GET_ACCOUNT_NO_OCC
FIELDS=ACCOUNT_NO

*FIELD_GROUP
NAME=POST_ACTIVITY_INPUT
FLIST_NAME=POST_ACTIVITY_INPUT
OCCRANCE_FLD=POST_ACTIVITY_OCC
FIELDS=LOGIN,SERVICE_TYPE,DESCR,RATES2

*FIELD_GROUP
NAME=POST_ACTIVITY_OUTPUT
FLIST_NAME=POST_ACTIVITY_OUTPUT
OCCRANCE_FLD=POST_ACTIVITY_OCC
FIELDS=OPS_ERROR,DESCR

*FIELD_GROUP
NAME=RATES2
FLIST_NAME=RATES
OCCRANCE_FLD=RATES2_INFO_OCC
FIELDS=NAME,IMPACT_CATEGORY,QUANTITY 

*FIELD_GROUP
NAME=LOGIN_INPUT
FLIST_NAME=LOGIN_INPUT
OCCRANCE_FLD=LOGIN_OCC
FIELDS=LOGIN,PASSWD_CLEAR,SERVICE_TYPE,DESCR,START_T

*FIELD_GROUP
NAME=LOGIN_OUTPUT
FLIST_NAME=LOGIN_OUTPUT
OCCRANCE_FLD=LOGIN_OCC
FIELDS=RESULT,TYPE,DESCR,HANDLE

*FIELD_GROUP
NAME=LOGOUT_INPUT
FLIST_NAME=LOGOUT_INPUT
OCCRANCE_FLD=LOGOUT_OCC
FIELDS=HANDLE,DESCR,END_T,RATES2

*FIELD_GROUP
NAME=LOGOUT_OUTPUT
FLIST_NAME=LOGOUT_OUTPUT
OCCRANCE_FLD=LOGOUT_OCC
FIELDS=OPS_ERROR,DESCR

*FIELD_GROUP
NAME=GET_SESSIONS_INPUT
FLIST_NAME=GET_SESSIONS_INPUT
OCCRANCE_FLD=SESSIONS_OCC
FIELDS=SERVICE_TYPE

*FIELD_GROUP
NAME=GET_SESSIONS_OUTPUT
FLIST_NAME=GET_SESSIONS_OUTPUT
OCCRANCE_FLD=SESSIONS_INFO_OCC
FIELDS=SESSIONS_INFO

*FIELD_GROUP
NAME=SESSIONS_INFO
FLIST_NAME=RESULTS
OCCRANCE_FLD=SESSIONS_OCC
FIELDS=HANDLE,START_T,LOGIN,SERVICE_TYPE,ACCOUNT_NO

*FIELD_GROUP
NAME=DEL_CUST_INPUT
FLIST_NAME=DEL_CUST_INPUT
OCCRANCE_FLD=DEL_CUST_OCC
FIELDS=ACCOUNT_NO

*FIELD_GROUP
NAME=DEL_CUST_OUTPUT
FLIST_NAME=DEL_CUST_OUTPUT
OCCRANCE_FLD=DEL_CUST_OCC
FIELDS=OPS_ERROR,DESCR

Modifying the Portal Infranet Configuration File

The eLink Adapter for Portal Infranet uses Portal Infranet libraries to connect to the Portal Infranet system. The file pin.conf (Unix) or pin.cnf (NT) is a configuration file that Portal Infranet libraries use to find the Portal Infranet system. This file must be installed in the application directory of the eLink Adapter for Portal Infranet. The following entries must be modified in the sample pin.conf file that is supplied with the adapter.

Entries that you must modify in the pin.conf (Unix) or pin.cnf (NT) file
Definition of each entry

nap login_name <login_name>

specifies the name to use when the adapter requests a connection to the Portal Infranet system.

nap login_pw <login_pw>

specifies the password to use when the adapter requests a connection to the Portal Infranet system.

nap cm_name <name>

the host name or TCP/IP address of the Portal Infranet system

nap cm_port <port>

the TCP/IP port to connect to the Portal Infranet system

Entries that you must modify in the pin.conf (Unix) or pin.cnf (NT) file	Definition of each entry
nap login_name <login_name>	specifies the name to use when the adapter requests a connection to the Portal Infranet system.
nap login_pw <login_pw>	specifies the password to use when the adapter requests a connection to the Portal Infranet system.
nap cm_name <name>	the host name or TCP/IP address of the Portal Infranet system
nap cm_port <port>	the TCP/IP port to connect to the Portal Infranet system

Listing 3-4 is a sample of the supplied example pin.conf or pin.cnf. The entries that need to be modified are highlighted in bold at the end of the file sample.

Listing 3-4 Sample pin.conf (pin.cnf)File

#===================================================================
# Configuration File for the Sample Object Creation Application
#===================================================================
#
#===================================================================
# Use this file to specify how the sample application connects with
# Infranet.
#
# A copy of this configuration file is automatically installed and
# configured with default values when you install Infranet. However,
# you can edit this file to suit your specific configuration:
# -- You can change the default value of an entry.
# -- You can exclude an optional entry by adding the # symbol
# at the beginning of the line.
# -- You can include a commented entry by removing the # symbol.
#
# Before you make any changes to this file, save a backup copy.
#
# To edit this file, follow the instructions in the commented sections.
# For more information on the general syntax of configuration entries,
# see "Reference Guide to Infranet Configuration Files" in the Infranet
# online documentation.
#======================================================================
#
#
#======================================================================
# cm_ptr
#
# Pointer to the CM/CMMP.
#
# Use a separate entry for each CM/CMMP. If the application can't
# find the first CM/CMMP, it looks for the next in the list.
#
# Each entry includes three values:
# -- <protocol>: the protocol must be "ip" for this release
# -- <hostname>: name or IP address of the computer running
# the CM/CMMP
# -- <port>: TCP port number of the CM/CMMP on this computer
#
# The port number should match a corresponding cm_ports entry with
# the same port number in the CM/CMMP configuration file. The
# default, 11960, is a commonly specified port for the CM/CMMP.
#======================================================================
- nap cm_ptr ip XXX 11960
#- nap cm_ptr ip <hostname2> <port2>
  
#======================================================================
# userid
#
# Database number and service type for the Infranet database.
#
# The CM uses the database number to identify the Infranet database
# and connect to the correct Data Manager. For connections that don't
# require a login name and password, the CM also passes the service
# type to the database.
#
# The database number, in the form 0.0.0.N, is the number assigned to
# your Infranet database when you installed the system. The default
# is 0.0.0.1.
#
# The service type is "/service/pcm_client", with an ID of "1".
# Do not change these values.
#======================================================================
- - userid 0.0.0.1 /service/pcm_client 1
#======================================================================
# These entries contain the login information for connecting
# to the CM:
#
# -- "login_type" specifies whether the login name and password
# are required. Type 1, the default, indicates that name and
# password are required. Type 0 indicates that only the user
# ID is required.
#
# -- "login_name" specifies the login name to use when the
# sample application requests a connection to the CM. If
# "login_type" is 0, you don't need to specify a login name.
#
# -- "login_pw" specifies the password to use when the sample
# application connects to the CM. If "login_type" is 0, you
# don't need to specify a password.
#======================================================================
- nap login_type 1
- nap login_name root
- nap login_pw password
- nap cm_name mynode
- nap cm_port 11960

The Portal Infranet Document Reference Guide to Infranet Configuration Files contains additional explanation of this configuration file.