PreviousNext
Help > API Functions > User spaces > i5_userspace_create
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

 

 

Return

 

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 Equipements. 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_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);