Re: [PHP-DOC] New entry to en/reference

2006-11-30 Thread Jakub Vrana
Owain Jones wrote:
 We've added new PHP functionality for IBM DB2 which requires a new
 section in en/reference. I'm not sure how to do this but I need a
 folder en/reference/pdo_ibm.

 It needs to contain the following .xml files and I also updated the
 global entity file to add two URL entities.

Done. I've also added PDO_IBM to pdo/reference.xml.

Jakub Vrana


[PHP-DOC] New entry to en/reference

2006-11-29 Thread Owain Jones
Hi,

We've added new PHP functionality for IBM DB2 which requires a new section 
in en/reference.  I'm not sure how to do this but I need a folder 
en/reference/pdo_ibm.

It needs to contain the following .xml files and I also updated the global 
entity file to add two URL entities.



Thanks,

Owain
---
Owain Jones
DB2 Information Development
IBM Toronto Lab, D4-416
Phone (work): 905-413-2196
[EMAIL PROTECTED]Index: en/entities/global.ent
===
RCS file: /repository/phpdoc/entities/global.ent,v
retrieving revision 1.259
diff -u -u -r1.259 global.ent
--- en/entities/global.ent  11 Feb 2006 20:38:12 -  1.259
+++ en/entities/global.ent  29 Nov 2006 20:22:26 -
@@ -123,6 +123,8 @@
 !ENTITY url.ibm.sdo 
http://www-128.ibm.com/developerworks/java/library/j-commonj-sdowmt/;
 !ENTITY url.ibm.sdo.spec 
ftp://www6.software.ibm.com/software/developer/library/j-commonj-sdowmt/Commonj-SDO-Specification-v2.0.pdf;
 !ENTITY url.ibmdb2 http://www-306.ibm.com/software/data/db2/;
+!ENTITY url.ibmdb2.ad http://www.ibm.com/software/data/db2/ad;
+!ENTITY url.ibmdb2.con http://www.ibm.com/software/data/db2/db2connect;
 !ENTITY url.icu http://icu.sourceforge.net/;
 !ENTITY url.icu.locales 
http://www-950.ibm.com/software/globalization/icu/demo/locales/en/?d_=en;
 !ENTITY url.iis http://support.microsoft.com/kb/q160422/;
?xml version='1.0' encoding='iso-8859-1'?
!-- $Revision: 1.3 $ --
!-- Purpose: database.vendors --
!-- Membership: external, pecl --

 reference id=ref.pdo-ibm
  titleIBM Functions (PDO_IBM)/title
  titleabbrevIBM (PDO)/titleabbrev
  partintro

   section id=pdo-ibm.intro
reftitle.intro;
para
 PDO_IBM is a driver that implements the link linkend=ref.pdoPHP Data
 Objects (PDO)/link interface to enable access from PHP to IBM databases.
/para
   /section

   !-- Information found in configure.xml --
   reference.pdo-ibm.configure;

  /partintro

  refentry id=ref.pdo-ibm.connection
   refnamediv
refnamePDO_IBM DSN/refname
refpurposeConnecting to IBM databases/refpurpose
   /refnamediv

   refsect1 role=description
reftitle.description;
para
 The PDO_IBM Data Source Name (DSN) is based on the IBM CLI DSN. The major 
 components of the PDO_IBM DSN are: 
 variablelist
  varlistentry
   termDSN prefix/term
   listitem
para
The DSN prefix is userinputibm:/userinput.
/para
   /listitem
  /varlistentry
  varlistentry
   termconstantDSN/constant/term
   listitem
para
 The DSN can be any of the following:
 itemizedlist
  listitem
   para
a) Data source setup using filenamedb2cli.ini/filename 
or filenameodbc.ini/filename
   /para
  /listitem
  listitem
   para
b) Catalogued database name i.e. database alias in the DB2 client 
catalog
   /para
  /listitem
  listitem
para
 c) Complete connection string in the following format: 
 literalDRIVER={IBM DB2 ODBC 
DRIVER};DATABASE=parameterdatabase/parameter;HOSTNAME=parameterhostname/parameter;PORT=parameterport/parameter;PROTOCOL=TCPIP;UID=parameterusername/parameter;PWD=parameterpassword/parameter;/literal
 
 where the parameters represent the following values:
 variablelist
  varlistentry
   termparameterdatabase/parameter/term
   listitem
para
 The name of the database.
/para
   /listitem
  /varlistentry
  varlistentry
   termparameterhostname/parameter/term
   listitem
para
 The hostname or IP address of the database server.
/para
   /listitem
  /varlistentry
  varlistentry
   termparameterport/parameter/term
   listitem
para
 The TCP/IP port on which the database is listening for
 requests.
/para
   /listitem
  /varlistentry
  varlistentry
   termparameterusername/parameter/term
   listitem
para
 The username with which you are connecting to the
 database.
/para
   /listitem
  /varlistentry
  varlistentry
   termparameterpassword/parameter/term
   listitem
para
 The password with which you are connecting to the database.
/para
   /listitem
  /varlistentry
 /variablelist
/para
   /listitem
  /itemizedlist