iUserSpace
- class iUserSpace(conn)
Note
Deprecated: Will be removed in the next major version.
- Arguments
conn (Connection) – The Connection object.
- iUserSpace.createUserSpace(name, lib, attr, size, auth, desc, cb)
Note
Deprecated: Will be removed in the next major version.
Create a new user space. IBM i API: QUSCRTUS
- Arguments
name (string) – The user space name. (10 characters max).
lib (string) – The library name.
attr (string) – The extended attribute of the user space (11 characters max).
size (number) – The initial size of the user space.
auth (string) – The authority to the user space.
desc (string) – The description of the user space (50 characters max).
cb (createUserSpaceCallback) –
- iUserSpace.deleteUserSpace(name, lib, cb)
Note
Deprecated: Will be removed in the next major version.
Delete the user space. IBM i API: QUSDLTUS
- Arguments
name (string) – The user space name.
lib (string) – The library name.
cb (deleteUserSpaceCallback) – The callback function.
- iUserSpace.getUserSpaceData(name, lib, length, cb)
Note
Deprecated: Will be removed in the next major version.
Retrieves the content of the user space. IBM i API: QUSRTVUS
- Arguments
name (string) – The user space name.
lib (string) – The library name.
length (string) – The length of the data to retrieve.
cb (getUserSpaceDataCallback) – The callback function.
- iUserSpace.setUserSpaceData(name, lib, length, msg, cb)
Note
Deprecated: Will be removed in the next major version.
Set the content of the user space. IBM i API: QUSCHGUS
- Arguments
name (string) – The user space name.
lib (string) – The library name.
length (string) – Tthe length of the data to set.
msg (string) – The data to set.
cb (setUserSpaceDataCallback) – The callback function.
- createUserSpaceCallback(error, output)
- Arguments
error (Error|null) – the error object if an error occured or null.
output (boolean|null) – This is true if successful or null when an error occurs.
- setUserSpaceDataCallback(error, output)
- Arguments
error (Error|null) – the error object if an error occured or null.
output (boolean|null) – This is true if successful or null when an error occurs.
- getUserSpaceDataCallback(error, output)
- Arguments
error (Error|null) – the error object if an error occured or null.
output (string|null) – This is the output from the user space if successful or null when an error occurs.
- deleteUserSpaceCallback(error, output)
- Arguments
error (Error|null) – the error object if an error occured or null.
output (boolean|null) – This is true if successful or null when an error occurs.
Examples
Create a new user space
const { Connection, iUserSpace } = require('itoolkit');
const connection = new Connection({
transport: 'ssh',
transportOptions: { host: 'myhost', username: 'myuser', password: 'mypassword' },
});
const userSpace = new iUserSpace(connection);
userSpace.createUserSpace('myuserspace', 'mylib', 'LOG', 50, 'EXCLUDE', 'Example User Space', (error, output) => {
if (error) {
throw error;
}
console.log(output);
});
Set the content of the user space
const { Connection, iUserSpace } = require('itoolkit');
const connection = new Connection({
transport: 'ssh',
transportOptions: { host: 'myhost', username: 'myuser', password: 'mypassword' },
});
const userSpace = new iUserSpace(connection);
userSpace.setUserSpaceData('myuserspace', 'mylib', 20, 'Hello!', (error, output) => {
if (error) {
throw error;
}
console.log(output);
});
Retrieve the content of the user space
const { Connection, iUserSpace } = require('itoolkit');
const connection = new Connection({
transport: 'ssh',
transportOptions: { host: 'myhost', username: 'myuser', password: 'mypassword' },
});
const userSpace = new iUserSpace(connection);
userSpace.getUserSpaceData('myuserspace', 'mylib', 20, (error, output) => {
if (error) {
throw error;
}
console.log(output);
});
Delete the user space
const { Connection, iUserSpace } = require('itoolkit');
const connection = new Connection({
transport: 'ssh',
transportOptions: { host: 'myhost', username: 'myuser', password: 'mypassword' },
});
const userSpace = new iUserSpace(connection);
userSpace.deleteUserSpace('myuserspace', 'mylib', (error, output) => {
if (error) {
throw error;
}
console.log(output);
});