Class: OCISession

Inherits:
OCIHandle show all
Defined in:
ext/oci8/oci8.c

Instance Method Summary collapse

Methods inherited from OCIHandle

#attrGet, #attrSet, #free, new

Instance Method Details

#begin(*args) ⇒ Object

begin

— OCISession#begin(svc [, credt [, mode]])

start user session under the specified server context.
:svc
   ((<OCISvcCtx>)).
:credt
   ((|OCI_CRED_RDBMS|)) or ((|OCI_CRED_EXT|)).
   Default value is ((|OCI_CRED_RDBMS|)).

   If you use ((|OCI_CRED_RDBMS|)), set ((<OCI_ATTR_USERNAME>))
   and ((<OCI_ATTR_PASSWORD>)) in advance.

:mode
   ((|OCI_DEFAULT|)), ((|OCI_MIGRATE|)), ((|OCI_SYSDBA|)), ((|OCI_SYSOPER|)),
   (((|OCI_SYSDBA|)) | ((|OCI_PRELIM_AUTH|))), or (((|OCI_SYSOPER|)) | ((|OCI_PRELIM_AUTH|))).
   Default value is ((|OCI_DEFAULT|)).

   If you need SYSDBA or SYSOPER privilege, use
   ((|OCI_SYSDBA|)) or ((|OCI_SYSOPER|)) respectively.

correspond native OCI function: ((|OCISessionBegin|))

end



42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
 
# File 'ext/oci8/session.c', line 42

static VALUE oci8_session_begin(int argc, VALUE *argv, VALUE self)
{
  VALUE vsvc, vcredt, vmode;
  oci8_handle_t *h;
  oci8_handle_t *svch;
  ub4 credt;
  ub4 mode;
  sword rv;

  rb_scan_args(argc, argv, "12", &vsvc, &vcredt, &vmode);
  Get_Handle(self, h); /* 0 */
  Check_Handle(vsvc, OCISvcCtx, svch); /* 1 */
  Get_Int_With_Default(argc, 2, vcredt, credt, OCI_NTV_SYNTAX); /* 2 */
  Get_Int_With_Default(argc, 3, vmode, mode, OCI_DEFAULT); /* 3 */

  rv = OCISessionBegin(svch->hp, h->errhp, h->hp, credt, mode);
  if (rv != OCI_SUCCESS)
    oci8_raise(h->errhp, rv, NULL);
  return self;
}

#end(*args) ⇒ Object

begin

— OCISession#end(svc [, vmode])

terminate user Authentication Context

:svc
   ((<OCISvcCtx>)).
:mode
   ((|OCI_DEFAULT|)) only valid. Defalt value is ((|OCI_DEFAULT|)).

correspond native OCI function: ((|OCISessionEnd|))

end



76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
 
# File 'ext/oci8/session.c', line 76

static VALUE oci8_session_end(int argc, VALUE *argv, VALUE self)
{
  VALUE vsvc, vmode;
  oci8_handle_t *h;
  oci8_handle_t *svch;
  ub4 mode;
  sword rv;

  rb_scan_args(argc, argv, "11", &vsvc, &vmode);
  Get_Handle(self, h); /* 0 */
  Check_Handle(vsvc, OCISvcCtx, svch); /* 1 */
  Get_Int_With_Default(argc, 2, vmode, mode, OCI_DEFAULT); /* 2 */

  rv = OCISessionEnd(svch->hp, h->errhp, h->hp, mode);
  if (rv != OCI_SUCCESS)
    oci8_raise(h->errhp, rv, NULL);
  return self;
}