i5_userspace_create

 

Creates a new user space object.

 

bool i5_userspace_create (

Array Properties
[, resource connection])

 

Parameters

 

 

properties

I5_INITSIZE – The initial size of the user space being created. This value must

be from 1 byte to 16, 776, 704 bytes.

I5_DESCRIPTION – user space text description

I5_INIT_VALUE – The initial value of all bytes in the user space.

I5_EXTEND_ATTRIBUT – extended attribute. The extended attribute must be a

valid *NAME. For example, an object type of *FILE has an extended attribute of

PF (physical file), LF (logical file), DSPF (display file), SAVF (save file), and so

on.

I5_AUTHORITY – The authority you give users who do not have specific private

or group authority to the user space

I5_LIBNAME – Library name where the user space is located

I5_NAME – User space name (10 char max)

 

connection

Result of i5_connect

 

Returns:

True if OK, false if failed.

 

I5_ERR_DESC_WRONG_DATAOP

41

Wrong operation on a data field of a description

I5_ERR_PARSEXML

42

Internal error; please contact Aura Equipement; error number 42

I5_ERR_PHP_OPTIONSTYPE

259

The type of " I5_OPTIONS_ALIAS" option must be x and not x

I5_ERR_PHP_OPTIONSNUMBER

260

Option number -1 is unknown.

I5_ERR_PHP_TYPEPARAM

262

Type of element x in parameter -1 must be y. Type z was provided.

I5_ERR_PHP_VARIABLE

281

You can't use the I5_bind_param function and specify parameters

I5_ERR_PHP_ELEMENT_MISSING

304

An element of the array has a wrong type within function_name(type) function.

I5_ERR_PHP_BAD_KEYNAME

306

Name x is not a property name for a program description

 

 

Example

 

 

$property = array(

  I5_INITSIZE=>10,

  I5_DESCRIPTION=>"User space created by PHP",

  I5_INIT_VALUE=>"A",

  I5_EXTEND_ATTRIBUT=>"wal",

  I5_AUTHORITY=>"*ALL",

  I5_LIBNAME=>"QTEMP",

  I5_NAME=>"USERSPACE"

 );

 $ret = i5_userspace_create($property);

 if (!$ret) trigger_error("i5_userspace_create error : ".i5_errormsg(), E_USER_ERROR);