Shell_Oracle Erp基于主机文件Host开发详解（案例）

2014-06-20 Created By BaoXinjian

一、摘要

---

Oracle 并发程式中Host Type的可执行程式，它的作用是用于调用Unix Shell去执行某些需求

个人觉得Oracle EBS中引入Host去调用unix shell其弥补了很多PLSQL类型程式无法做的某些功能，以unix shell的语法结构直接对服务器进行操作

写host并发程式时，需要较强的Bash语法知识，个人不做DBA，只了解一部分，所以就不具体介绍了，只说明一下Oracle EBS开发Unix Shell时需要注意的地方

1. Host并发程式中必须定义的4个系统参数，自定义参数可以从第5个开始引用

ORA_USER_PASS=$1

ORA_USER_ID=$2

ORA_LOGIN_NAME=$3

ORA_REQUEST_ID=$4

2 Prog文件放置时必须注意读写权限，最好是777，避免无法应用

3 并发程式设定好之后，注意通过fndcpesr建立虚拟连接

ln -s $FND_TOP/bin/fndcpesr $FND_TOP/bin/bxjhosts

4. 文件后缀名不是.sh， 而是.prog

5. 当Shell调用需返回Waring或者Log信息给并发程式管理器时，可通过API<fnd_concurrent><fnd_file.log/output>

fnd_global.INITIALIZE(l_session_id, null, null, null,null, -1, null, null, null, null, $4, null,null,null,null,null,null,-1);

l_result := fnd_concurrent.set_completion_status(‘WARNING’,'Review log file for details.’);

 

二、案例分析

---

案例： 创建一个Host并发程式，自定义2个参数，将Host自带的4个系统参数和2个自定义参数在host程式运行后，自动存放至记录表中

1. 创建一个测试表，用以存放Host并发程式传入的参数

create table bxj_hosts_test(
  ora_user_pass varchar2(50),   ->必须定义的系统参数用户及密码
  ora_user_id varchar2(50),       ->必须定义的系统参数用户ID
  ora_login_name varchar2(50), ->必须定义的系统参数用户名
  ora_request_id varchar2(50),   ->必须定义的系统Request_ID
  invoice_id varchar2(50),          ->自定义参数
  invoice_number varchar2(240),->自定义参数
  creation_date date
);

2. 建立一个后缀名为prog的Unix Shell文件，采用Bash语法，其构成为4部分

2.1 定义从并发管理器传入的4个默认系统参数和2个自定义参数

2.2 准备SQL文件用以之后调用，并产生$ORACLE_PATH/bxjhosts.sql

2.3 通过SQLPLUS执行第二步产生的SQL文件

2.4 根据SQLPLUS中的DBMSOUT，产生LOG文件

#/bin/bash  
# +--------------------------------------------+  
# + An example of calling host concurrent      +   
# + Author: Gavin.Bao                          +                                
# +--------------------------------------------+  
#  
# ---------------------------------  
#  Define variable
# ---------------------------------  
  
export ORA_USER_PASS=$1
export ORA_USER_ID=$2 
export ORA_LOGIN_NAME=$3 
export ORA_REQUEST_ID=$4 

export INVOICE_ID=$5
export INVOICE_NUMBER=$6

export ORACLE_PATH="/home/applvis/bts"
  
# ---------------------------------  
#  Prepare plsql script  
# ---------------------------------  
  
echo "set serveroutput on size 1000000" > $ORACLE_PATH/bxjhosts.sql  
echo "set feed off" >> $ORACLE_PATH/bxjhosts.sql  
echo "begin" >> $ORACLE_PATH/bxjhosts.sql  
echo "  insert into bxj_hosts_test " >> $ORACLE_PATH/bxjhosts.sql  
echo "  values ('$ORA_USER_PASS','$ORA_USER_ID','$ORA_LOGIN_NAME', '$ORA_REQUEST_ID', '$INVOICE_ID', '$INVOICE_NUMBER', SYSDATE);" >>$ORACLE_PATH/bxjhosts.sql
echo "  commit;" >>$ORACLE_PATH/bxjhosts.sql
echo "  dbms_output.put_line('Excuted Sucessfully.');" >> $ORACLE_PATH/bxjhosts.sql  
echo "exception when others then" >> $ORACLE_PATH/bxjhosts.sql  
echo "  rollback;" >> $ORACLE_PATH/bxjhosts.sql  
echo "  dbms_output.put_line('Executed Failed');" >> $ORACLE_PATH/bxjhosts.sql  
echo "  dbms_output.put_line('SQLCODE='||SQLCODE);" >> $ORACLE_PATH/bxjhosts.sql  
echo "  dbms_output.put_line('SQLERRM='||SQLERRM);" >> $ORACLE_PATH/bxjhosts.sql  
echo "end;" >> $ORACLE_PATH/bxjhosts.sql  
echo "/" >> $ORACLE_PATH/bxjhosts.sql
  
# --------------------------------  
#  Execute plsql script  
# --------------------------------  
  
if [ -s $ORACLE_PATH/bxjhosts.sql ]; then  
    echo -e "Running SQL script to find out bdump directory... \n"   
    $ORACLE_HOME/bin/sqlplus -s apps/apps > $ORACLE_PATH/bxjhosts.log << EOF  
    @$ORACLE_PATH/bxjhosts.sql  
EOF
fi

# --------------------------------  
#  Execute generate log file
# --------------------------------  
echo "Check the reslut "
echo "------------------------"
cat $ORACLE_PATH/bxjhosts.log
  
echo "bxjhosts.sh excuted end"

3. 在application定义Excutable 和 Concurrent Program之前，在Unix环境下测试Prog文件，确保该文件没有问题，不存在语法错误

4. 配置Prog文件读写权限和使用fndcpesr建立bxjhosts.prog的虚拟连接

4.1设定权限：　chmod 777 bxjhosts.prog

4.2建立虚拟连接： ln -s $FND_TOP/bin/fndcpesr $FND_TOP/bin/bxjhosts

5. 语法没有任何问题，定义Excutable和Concurrent Program

Unix Shell中前4个参数，系统会默认赋值，从5个参数开始，才真正从并发程式的定义中取值

 

三、案例测试

---

 Test1. 调用该程式

Test2. 在执行Host并发程式中，因为在Prog中定义了两个文件产生方式如下

Test2.1 SQL文件用以最终Prog Shell最终执行哪段SQL

Test2.2 LOG文件用以最终Prog Shell执行过程中的Log语法

 

Test3. 将Host Prog中的Insert语句执行结果如下，4个系统参数，2个用户自定义参数

 

四、 案例中遇到的问题

---

Issue1 调用程式时提示无法找到该host文件，无法被执行，原因在于prog文件的权限问题和虚拟连接是否建立

 

Thanks and Regards