9.49 DESTROY_SPACE
Note: Built-In Function Rules Usage Options
Destroys the space object with the specified name.
Arguments
No
|
Type
|
Req/ Opt
|
Description
|
Min Len
|
Max Len
|
Min Dec
|
Max Dec
|
1
|
A
|
R
|
Space Name.
Special space name *ALL may be used to destroy all spaces within the current operating system process.
|
1
|
256
|
|
|
|
Return Values
No
|
Type
|
Req/ Opt
|
Description
|
Min Len
|
Max Len
|
Min Dec
|
Max Dec
|
1
|
A
|
O
|
Standard Return Code
"OK" = Space destroyed or does not exist.
"ER" = Destruction attempt failed. Messages issued will indicate more about the cause of the failure.
|
2
|
2
|
|
|
|
Technical Notes
Once a space object has been destroyed it can no longer be used.