Difference between revisions of "VMS-Specific Python Modules"

From VSI OpenVMS Wiki
Jump to: navigation, search
(ExecI(st:str)->int)
Line 5: Line 5:
 
=== dlopen_test(name:str)->int ===
 
=== dlopen_test(name:str)->int ===
 
Tries to open a shared image.
 
Tries to open a shared image.
==== parameters ====
+
<br>''parameters''<br>
 
* <code>name:str</code> path to the shared image
 
* <code>name:str</code> path to the shared image
==== returns ====
+
<br>''returns''<br>
 
* <code>1</code> if the shared image exists and can be opened by dlopen()
 
* <code>1</code> if the shared image exists and can be opened by dlopen()
 
* <code>0</code> otherwise
 
* <code>0</code> otherwise
Line 13: Line 13:
 
=== fix_time(vms_time:int)->int ===
 
=== fix_time(vms_time:int)->int ===
 
Converts VMS time to the Unix time.
 
Converts VMS time to the Unix time.
==== parameters ====
+
<br>''parameters''<br>
 
* <code>vms_time:int</code> VMS system time
 
* <code>vms_time:int</code> VMS system time
==== returns ====
+
<br>''returns''<br>
 
Time in Unix format (seconds that have elapsed since 1970.01.01)
 
Time in Unix format (seconds that have elapsed since 1970.01.01)
  
 
=== from_vms(vms_path:str, wild_flag:int)->list ===
 
=== from_vms(vms_path:str, wild_flag:int)->list ===
 
Converts VMS path to a list of Unix paths.
 
Converts VMS path to a list of Unix paths.
==== parameters ====
+
<br>''parameters''<br>
 
* <code>vms_path:str</code> path in VMS format (supports wildcards)
 
* <code>vms_path:str</code> path in VMS format (supports wildcards)
 
* <code>wild_flag:int</code> If set to <code>0</code>, wildcards found in the <code>vms_path</code> are not expanded  
 
* <code>wild_flag:int</code> If set to <code>0</code>, wildcards found in the <code>vms_path</code> are not expanded  
==== returns ====
+
<br>''returns''<br>
 
List of paths in Unix format
 
List of paths in Unix format
  
 
=== getenv(name:str, def_value:str)->str ===
 
=== getenv(name:str, def_value:str)->str ===
 
Gets the specified environment variable value. See getenv() description in the '''C Run-Time Library Reference Manual for OpenVMS Systems''' documentation.
 
Gets the specified environment variable value. See getenv() description in the '''C Run-Time Library Reference Manual for OpenVMS Systems''' documentation.
==== parameters ====
+
<br>''parameters''<br>
 
* <code>name:str</code> name of the environment variable
 
* <code>name:str</code> name of the environment variable
 
* <code>def_value:str</code> default value
 
* <code>def_value:str</code> default value
==== returns ====
+
<br>''returns''<br>
 
Environment variable value
 
Environment variable value
  
 
=== sleep(seconds:int)->int ===
 
=== sleep(seconds:int)->int ===
 
Suspends execution of the current process or thread for the specified number of seconds.
 
Suspends execution of the current process or thread for the specified number of seconds.
==== parameters ====
+
<br>''parameters''<br>
 
* <code>seconds:int</code> seconds to sleep
 
* <code>seconds:int</code> seconds to sleep
==== returns ====
+
<br>''returns''<br>
 
The number of seconds left to the end of the sleep period if sleep is interrupted.
 
The number of seconds left to the end of the sleep period if sleep is interrupted.
 
<code>0</code> if the process slept for the specified number of seconds.
 
<code>0</code> if the process slept for the specified number of seconds.
Line 44: Line 44:
 
=== sysconf(name:int)->int ===
 
=== sysconf(name:int)->int ===
 
Provides a method for determining the current value of a configurable system limit or whether optional features are supported.
 
Provides a method for determining the current value of a configurable system limit or whether optional features are supported.
==== parameters ====
+
<br>''parameters''<br>
 
* <code>name:int</code> system variable to be queried
 
* <code>name:int</code> system variable to be queried
==== returns ====
+
<br>''returns''<br>
 
Requested value
 
Requested value
  
 
=== to_vms(unix_path:str, allow_wild:int, no_directory:int)->list ===
 
=== to_vms(unix_path:str, allow_wild:int, no_directory:int)->list ===
 
Converts UNIX style file specifications to OpenVMS file specifications.
 
Converts UNIX style file specifications to OpenVMS file specifications.
==== parameters ====
+
<br>''parameters''<br>
 
* <code>unix_path:str</code> file name in UNIX style file specification format
 
* <code>unix_path:str</code> file name in UNIX style file specification format
 
* <code>allow_wild:int</code> If set to <code>0</code>, wildcards found in <code>unix_path</code> are not expanded
 
* <code>allow_wild:int</code> If set to <code>0</code>, wildcards found in <code>unix_path</code> are not expanded
Line 58: Line 58:
 
** 1 - Prevent expansion of the string as a directory name
 
** 1 - Prevent expansion of the string as a directory name
 
** 2 - Force expansion of the string as a directory name
 
** 2 - Force expansion of the string as a directory name
==== returns ====
+
<br>''returns''<br>
 
List of paths in OpenVMS style
 
List of paths in OpenVMS style
  
 
=== unixtime(vms_time:int)->int ===
 
=== unixtime(vms_time:int)->int ===
 
Converts OpenVMS system time to the Unix local time.
 
Converts OpenVMS system time to the Unix local time.
==== parameters ====
+
<br>''parameters''<br>
 
* <code>vms_time:int</code> OpenVMS system time
 
* <code>vms_time:int</code> OpenVMS system time
==== returns ====
+
<br>''returns''<br>
 
Unix time
 
Unix time
  
 
=== vmstime(unix_time:int)->int ===
 
=== vmstime(unix_time:int)->int ===
 
Converts Unix time to the OpenVMS system time.
 
Converts Unix time to the OpenVMS system time.
==== parameters ====
+
<br>''parameters''<br>
 
* <code>unix_time:int</code> Unix time
 
* <code>unix_time:int</code> Unix time
==== returns ====
+
<br>''returns''<br>
 
OpenVMS system time
 
OpenVMS system time
  
Line 80: Line 80:
 
=== new()->object ===
 
=== new()->object ===
 
Creates empty item list.
 
Creates empty item list.
==== parameters ====
+
<br>''parameters''<br>
 
<code>None</code>
 
<code>None</code>
==== returns ====
+
<br>''returns''<br>
 
New empty item list
 
New empty item list
  
 
=== delete(il:object)->None ===
 
=== delete(il:object)->None ===
 
Deletes item list.
 
Deletes item list.
==== parameters ====
+
<br>''parameters''<br>
 
* <code>il:object</code> item list to be removed
 
* <code>il:object</code> item list to be removed
==== returns ====
+
<br>''returns''<br>
 
OpenVMS system time
 
OpenVMS system time
  
 
=== size(il:object)->int ===
 
=== size(il:object)->int ===
 
Gets size of the item list.
 
Gets size of the item list.
==== parameters ====
+
<br>''parameters''<br>
 
* <code>il:object</code> item list
 
* <code>il:object</code> item list
==== returns ====
+
<br>''returns''<br>
 
The size of the specified item list
 
The size of the specified item list
  
 
=== addint(il:object, item:int, item_type:int, item_value:int)->None ===
 
=== addint(il:object, item:int, item_type:int, item_value:int)->None ===
 
Adds a new integer to the item list.
 
Adds a new integer to the item list.
==== parameters ====
+
<br>''parameters''<br>
 
* <code>il:object</code> item list
 
* <code>il:object</code> item list
 
* <code>item:int</code> item to add
 
* <code>item:int</code> item to add
 
* <code>item_type:int</code> type of the item. See '''vms.dscdef'''
 
* <code>item_type:int</code> type of the item. See '''vms.dscdef'''
 
* <code>item_value:int</code> value of the item
 
* <code>item_value:int</code> value of the item
==== returns ====
+
<br>''returns''<br>
 
<code>None</code>
 
<code>None</code>
  
 
=== getint(il:object, index:int)->int ===
 
=== getint(il:object, index:int)->int ===
 
Gets the integer at the specified index in the list.
 
Gets the integer at the specified index in the list.
==== parameters ====
+
<br>''parameters''<br>
 
* <code>il:object</code> item list
 
* <code>il:object</code> item list
 
* <code>index:int</code> index of the item to get
 
* <code>index:int</code> index of the item to get
==== returns ====
+
<br>''returns''<br>
 
Integer value
 
Integer value
  
 
=== gethex(il:object, index:int)->str ===
 
=== gethex(il:object, index:int)->str ===
 
Gets the integer at the specified index in the item list and returns it as a hexadecimal string.
 
Gets the integer at the specified index in the item list and returns it as a hexadecimal string.
==== parameters ====
+
<br>''parameters''<br>
 
* <code>il:object</code> item list
 
* <code>il:object</code> item list
 
* <code>index:int</code> index of the item to get
 
* <code>index:int</code> index of the item to get
==== returns ====
+
<br>''returns''<br>
 
Hexadecimal string
 
Hexadecimal string
  
 
=== addstr(il:object, item:int, item_value:str, item_length:int)->None ===
 
=== addstr(il:object, item:int, item_value:str, item_length:int)->None ===
 
Adds the specified string to the item list. If the <code>item_value</code> is not <code>None</code>, the <code>item_length</code> is ignored and the length of the buffer will be the same as the length of the <code>item_value</code>.
 
Adds the specified string to the item list. If the <code>item_value</code> is not <code>None</code>, the <code>item_length</code> is ignored and the length of the buffer will be the same as the length of the <code>item_value</code>.
==== parameters ====
+
<br>''parameters''<br>
 
* <code>il:object</code> item list
 
* <code>il:object</code> item list
 
* <code>item:int</code> item to add
 
* <code>item:int</code> item to add
 
* <code>item_value:str</code> value to add (or <code>None</code>)
 
* <code>item_value:str</code> value to add (or <code>None</code>)
 
* <code>item_length:int</code> length of the buffer if the <code>item_value</code> is <code>None</code>
 
* <code>item_length:int</code> length of the buffer if the <code>item_value</code> is <code>None</code>
==== returns ====
+
<br>''returns''<br>
 
<code>None</code>
 
<code>None</code>
  
 
=== addstrd(il:object, item:int, item_value:str, item_length:int)->None ===
 
=== addstrd(il:object, item:int, item_value:str, item_length:int)->None ===
 
Adds the specified space-expanded string to the item list. The first byte of the buffer is the length of the string. If the <code>item_value</code> is longer than the <code>item_length</code>, it will be truncated.
 
Adds the specified space-expanded string to the item list. The first byte of the buffer is the length of the string. If the <code>item_value</code> is longer than the <code>item_length</code>, it will be truncated.
==== parameters ====
+
<br>''parameters''<br>
 
* <code>il:object</code> item list
 
* <code>il:object</code> item list
 
* <code>item:int</code> item to add
 
* <code>item:int</code> item to add
 
* <code>item_value:str</code> value to add
 
* <code>item_value:str</code> value to add
 
* <code>item_length:int</code> length of the buffer (the resulting string length is one byte less)
 
* <code>item_length:int</code> length of the buffer (the resulting string length is one byte less)
==== returns ====
+
<br>''returns''<br>
 
<code>None</code>
 
<code>None</code>
  
 
=== addstrn(il:object, item:int, item_value:str, item_length:int)->None ===
 
=== addstrn(il:object, item:int, item_value:str, item_length:int)->None ===
 
Adds the specified space-expanded string to the item list. If the <code>item_value</code> is longer than the <code>item_length</code>, it will be truncated.
 
Adds the specified space-expanded string to the item list. If the <code>item_value</code> is longer than the <code>item_length</code>, it will be truncated.
==== parameters ====
+
<br>''parameters''<br>
 
* <code>il:object</code> item list
 
* <code>il:object</code> item list
 
* <code>item:int</code> item to add
 
* <code>item:int</code> item to add
 
* <code>item_value:str</code> value to add
 
* <code>item_value:str</code> value to add
 
* <code>item_length:int</code> length of the buffer
 
* <code>item_length:int</code> length of the buffer
==== returns ====
+
<br>''returns''<br>
 
<code>None</code>
 
<code>None</code>
  
 
=== getstr(il:object, index:int, flag:int)->str ===
 
=== getstr(il:object, index:int, flag:int)->str ===
 
Gets the string at the specified index in the item list.
 
Gets the string at the specified index in the item list.
==== parameters ====
+
<br>''parameters''<br>
 
* <code>il:object</code> item list
 
* <code>il:object</code> item list
 
* <code>index:int</code> index of the item to get
 
* <code>index:int</code> index of the item to get
 
* <code>flag:int</code> if set to <code>1</code>, the first byte of the resulting string is the length of the string
 
* <code>flag:int</code> if set to <code>1</code>, the first byte of the resulting string is the length of the string
==== returns ====
+
<br>''returns''<br>
 
String
 
String
  
 
=== addbin(il:object, item:int, item_value:int, item_offset:int, item_len:int)->None ===
 
=== addbin(il:object, item:int, item_value:int, item_offset:int, item_len:int)->None ===
 
Adds a new binary item to the list. It will be interpreted as a string.
 
Adds a new binary item to the list. It will be interpreted as a string.
==== parameters ====
+
<br>''parameters''<br>
 
* <code>il:object</code> item list
 
* <code>il:object</code> item list
 
* <code>item:int</code> item to add
 
* <code>item:int</code> item to add
Line 172: Line 172:
 
* <code>item_offset:int</code> starting byte
 
* <code>item_offset:int</code> starting byte
 
* <code>item_len:int</code> amount of bytes
 
* <code>item_len:int</code> amount of bytes
==== returns ====
+
<br>''returns''<br>
 
<code>None</code>
 
<code>None</code>
  
 
=== getbyte(il:object, index:int, item_offset:int)->int ===
 
=== getbyte(il:object, index:int, item_offset:int)->int ===
 
Gets the byte at the specified position in the item list.
 
Gets the byte at the specified position in the item list.
==== parameters ====
+
<br>''parameters''<br>
 
* <code>il:object</code> item list
 
* <code>il:object</code> item list
 
* <code>index:int</code> index of the item
 
* <code>index:int</code> index of the item
 
* <code>item_offset:int</code> starting byte
 
* <code>item_offset:int</code> starting byte
==== returns ====
+
<br>''returns''<br>
 
Integer value of the specified byte
 
Integer value of the specified byte
  
Line 189: Line 189:
 
=== create_dir(name:str, uic:int, pe:int, pv:int)->int ===
 
=== create_dir(name:str, uic:int, pe:int, pv:int)->int ===
 
Creates a directory.
 
Creates a directory.
==== parameters ====
+
<br>''parameters''<br>
 
* <code>name:str</code> name of the directory to be created (specified in OpenVMS style)
 
* <code>name:str</code> name of the directory to be created (specified in OpenVMS style)
 
* <code>uic:int</code> unsigned integer value of the owner UIC:  
 
* <code>uic:int</code> unsigned integer value of the owner UIC:  
Line 196: Line 196:
 
* <code>pe:int</code> protection enable. See full documentation in the '''OpenVMS RTL Library(LIB$) Manual''' for LIB$CREATE_DIR.
 
* <code>pe:int</code> protection enable. See full documentation in the '''OpenVMS RTL Library(LIB$) Manual''' for LIB$CREATE_DIR.
 
* <code>pv:int</code> protection value
 
* <code>pv:int</code> protection value
==== returns ====
+
<br>''returns''<br>
 
* <code>vms.ssdef.SS__CREATED</code> one or more directories created
 
* <code>vms.ssdef.SS__CREATED</code> one or more directories created
 
* <code>vms.ssdef.SS__NORMAL</code> all specified directories already exist
 
* <code>vms.ssdef.SS__NORMAL</code> all specified directories already exist
Line 203: Line 203:
 
=== date_time()->list ===
 
=== date_time()->list ===
 
Gets current date and time.
 
Gets current date and time.
==== parameters ====
+
<br>''parameters''<br>
 
<code>None</code>
 
<code>None</code>
==== returns ====
+
<br>''returns''<br>
 
The list:
 
The list:
 
* <code>int</code> status code of the operation
 
* <code>int</code> status code of the operation
Line 212: Line 212:
 
=== get_ef()->list ===
 
=== get_ef()->list ===
 
Allocates a local event flag.
 
Allocates a local event flag.
==== parameters ====
+
<br>''parameters''<br>
 
<code>None</code>
 
<code>None</code>
==== returns ====
+
<br>''returns''<br>
 
The list:
 
The list:
 
* <code>int</code> status code of the operation
 
* <code>int</code> status code of the operation
Line 221: Line 221:
 
=== free_ef(ef:int)->int ===
 
=== free_ef(ef:int)->int ===
 
Releases the local event flag.  
 
Releases the local event flag.  
==== parameters ====
+
<br>''parameters''<br>
 
* <code>ef:int</code> the local event flag
 
* <code>ef:int</code> the local event flag
==== returns ====
+
<br>''returns''<br>
 
Status code of the operation
 
Status code of the operation
  
 
=== put_common(common:str)->int ===
 
=== put_common(common:str)->int ===
 
Copies a string into the common area.  
 
Copies a string into the common area.  
==== parameters ====
+
<br>''parameters''<br>
 
* <code>common:str</code> string to copy
 
* <code>common:str</code> string to copy
==== returns ====
+
<br>''returns''<br>
 
Status code of the operation
 
Status code of the operation
  
 
=== get_common()->list ===
 
=== get_common()->list ===
 
Gets the string from the common area.
 
Gets the string from the common area.
==== parameters ====
+
<br>''parameters''<br>
 
<code>None</code>
 
<code>None</code>
==== returns ====
+
<br>''returns''<br>
 
The list:
 
The list:
 
* <code>int</code> status code of the operation
 
* <code>int</code> status code of the operation
Line 244: Line 244:
 
=== get_hostname(flags:int)->list ===
 
=== get_hostname(flags:int)->list ===
 
Gets the host name of the local system.
 
Gets the host name of the local system.
==== parameters ====
+
<br>''parameters''<br>
 
* <code>flags:int</code> if set to <code>1</code>, the host node name is returned in the parsable form
 
* <code>flags:int</code> if set to <code>1</code>, the host node name is returned in the parsable form
==== returns ====
+
<br>''returns''<br>
 
The list:
 
The list:
 
* <code>int</code> status code of the operation
 
* <code>int</code> status code of the operation
Line 253: Line 253:
 
=== getjpi(item_code:int, pid:int, pname:str)->list ===
 
=== getjpi(item_code:int, pid:int, pname:str)->list ===
 
Gets the specified job/process information as a string.
 
Gets the specified job/process information as a string.
==== parameters ====
+
<br>''parameters''<br>
 
* <code>item_code:int</code> item identifier code defining the item of information to be returned. See '''vms.jpidef'''
 
* <code>item_code:int</code> item identifier code defining the item of information to be returned. See '''vms.jpidef'''
 
* <code>pid:int</code> process id
 
* <code>pid:int</code> process id
 
* <code>pname:str</code> process name
 
* <code>pname:str</code> process name
 
For valid combination of the values of <code>pid</code> and <code>pname</code> see the '''OpenVMS RTL Library(LIB$) Manual''' for LIB$GETJPI. The resulting <code>pid</code> is not returned.
 
For valid combination of the values of <code>pid</code> and <code>pname</code> see the '''OpenVMS RTL Library(LIB$) Manual''' for LIB$GETJPI. The resulting <code>pid</code> is not returned.
==== returns ====
+
<br>''returns''<br>
 
The list:
 
The list:
 
* <code>int</code> status code of the operation
 
* <code>int</code> status code of the operation
Line 265: Line 265:
 
=== getsyi(item_code:int, node_name:str)->list ===
 
=== getsyi(item_code:int, node_name:str)->list ===
 
Gets system wide information as a string.
 
Gets system wide information as a string.
==== parameters ====
+
<br>''parameters''<br>
 
* <code>item_code:int</code> item identifier code defining the item of information to be returned. See '''vms.syidef'''
 
* <code>item_code:int</code> item identifier code defining the item of information to be returned. See '''vms.syidef'''
 
* <code>node_name:str</code> node name
 
* <code>node_name:str</code> node name
==== returns ====
+
<br>''returns''<br>
 
The list:
 
The list:
 
* <code>int</code> status code of the operation
 
* <code>int</code> status code of the operation
Line 276: Line 276:
 
=== spawn(command:str, input_file:str, output_file:str, flags:int, pname:str)->list ===
 
=== spawn(command:str, input_file:str, output_file:str, flags:int, pname:str)->list ===
 
Requests the command language interpreter (CLI) of the calling process to spawn a subprocess for executing CLI commands.
 
Requests the command language interpreter (CLI) of the calling process to spawn a subprocess for executing CLI commands.
==== parameters ====
+
<br>''parameters''<br>
 
* <code>command:str</code> command to execute
 
* <code>command:str</code> command to execute
 
* <code>input_file:str</code> equivalence name to be associated with the logical name SYS$INPUT
 
* <code>input_file:str</code> equivalence name to be associated with the logical name SYS$INPUT
Line 282: Line 282:
 
* <code>flags:int</code> flag bits that designate optional behavior. See '''vms.clidef'''
 
* <code>flags:int</code> flag bits that designate optional behavior. See '''vms.clidef'''
 
* <code>pname:str</code> name defined for the subprocess
 
* <code>pname:str</code> name defined for the subprocess
==== returns ====
+
<br>''returns''<br>
 
The list:
 
The list:
 
* <code>int</code> status code of the operation
 
* <code>int</code> status code of the operation
Line 289: Line 289:
 
=== do_command(command:str)->None ===
 
=== do_command(command:str)->None ===
 
Stops program execution and directs the command language interpreter (CLI) to execute a command that is supplied as the argument.
 
Stops program execution and directs the command language interpreter (CLI) to execute a command that is supplied as the argument.
==== parameters ====
+
<br>''parameters''<br>
 
* <code>command:str</code> command to execute
 
* <code>command:str</code> command to execute
==== returns ====
+
<br>''returns''<br>
 
If successful, it does not return control to the calling program.
 
If successful, it does not return control to the calling program.
  
Line 299: Line 299:
 
=== asctim(vms_time:int, time_only:int)->list ===
 
=== asctim(vms_time:int, time_only:int)->list ===
 
Converts an absolute or delta time from 64-bit system time format to an ASCII string.
 
Converts an absolute or delta time from 64-bit system time format to an ASCII string.
==== parameters ====
+
<br>''parameters''<br>
 
* <code>vms_time:int</code> OpenVMS system time. A negative time value represents a delta time.
 
* <code>vms_time:int</code> OpenVMS system time. A negative time value represents a delta time.
 
* <code>time_only:int</code> if set to <code>1</code>, asctim returns the hour only.
 
* <code>time_only:int</code> if set to <code>1</code>, asctim returns the hour only.
==== returns ====
+
<br>''returns''<br>
 
The list:
 
The list:
 
* <code>int</code> status code of the operation
 
* <code>int</code> status code of the operation
Line 309: Line 309:
 
=== bintim(time_str:str)->list ===
 
=== bintim(time_str:str)->list ===
 
Converts an ASCII string to an absolute or delta time value in the system 64-bit time format.
 
Converts an ASCII string to an absolute or delta time value in the system 64-bit time format.
==== parameters ====
+
<br>''parameters''<br>
 
* <code>time_str:str</code> in format:
 
* <code>time_str:str</code> in format:
 
** Absolute Time: dd-mmm-yyyy hh:mm:ss.cc
 
** Absolute Time: dd-mmm-yyyy hh:mm:ss.cc
 
** Delta Time: dddd hh:mm:ss.cc
 
** Delta Time: dddd hh:mm:ss.cc
==== returns ====
+
<br>''returns''<br>
 
The list:
 
The list:
 
* <code>int</code> status code of the operation
 
* <code>int</code> status code of the operation
Line 320: Line 320:
 
=== asctoid(name:str)->list ===
 
=== asctoid(name:str)->list ===
 
Translates the specified identifier name into its binary identifier value.
 
Translates the specified identifier name into its binary identifier value.
==== parameters ====
+
<br>''parameters''<br>
 
* <code>name:str</code> identifier name
 
* <code>name:str</code> identifier name
==== returns ====
+
<br>''returns''<br>
 
The list:
 
The list:
 
* <code>int</code> status code of the operation
 
* <code>int</code> status code of the operation
Line 330: Line 330:
 
=== idtoasc(id_val:int, context:int)->list ===
 
=== idtoasc(id_val:int, context:int)->list ===
 
Translates the specified identifier value to the identifier name.
 
Translates the specified identifier value to the identifier name.
==== parameters ====
+
<br>''parameters''<br>
 
* <code>id_val:int</code> identifier value. See '''OpenVMS System Services Reference Manual''' for SYS$IDTOASC
 
* <code>id_val:int</code> identifier value. See '''OpenVMS System Services Reference Manual''' for SYS$IDTOASC
 
* <code>context:int</code> context value used when <code>idtoasc</code> is called repeatedly. Must be initialized with the value 0.
 
* <code>context:int</code> context value used when <code>idtoasc</code> is called repeatedly. Must be initialized with the value 0.
==== returns ====
+
<br>''returns''<br>
 
The list:
 
The list:
 
* <code>int</code> status code of the operation
 
* <code>int</code> status code of the operation
Line 343: Line 343:
 
=== crembx(tmp:int, maxmsg:int, bufquo:int, promsk:int, acmode:int, mbx_name:string, flags:int)->list ===
 
=== crembx(tmp:int, maxmsg:int, bufquo:int, promsk:int, acmode:int, mbx_name:string, flags:int)->list ===
 
Creates a virtual mailbox device.
 
Creates a virtual mailbox device.
==== parameters ====
+
<br>''parameters''<br>
 
* <code>tmp:int</code> the first bit specifies a permanent mailbox  
 
* <code>tmp:int</code> the first bit specifies a permanent mailbox  
 
* <code>maxmsg:int</code> maximum size of a message (in bytes)
 
* <code>maxmsg:int</code> maximum size of a message (in bytes)
Line 351: Line 351:
 
* <code>mbx_name:string</code> logical name to be assigned to the mailbox
 
* <code>mbx_name:string</code> logical name to be assigned to the mailbox
 
* <code>flags:int</code> options for the assign operation. See '''vms.cmbdef'''
 
* <code>flags:int</code> options for the assign operation. See '''vms.cmbdef'''
==== returns ====
+
<br>''returns''<br>
 
The list:
 
The list:
 
* <code>int</code> status code of the operation
 
* <code>int</code> status code of the operation
Line 358: Line 358:
 
=== delmbx(channel:int)->int ===
 
=== delmbx(channel:int)->int ===
 
Marks a permanent mailbox for deletion.
 
Marks a permanent mailbox for deletion.
==== parameters ====
+
<br>''parameters''<br>
 
* <code>channel:int</code> mailbox channel
 
* <code>channel:int</code> mailbox channel
==== returns ====
+
<br>''returns''<br>
 
Status code
 
Status code
  
 
=== assign(devnam:str, acmode:int, mbxnam:str, flags:int)->list ===
 
=== assign(devnam:str, acmode:int, mbxnam:str, flags:int)->list ===
 
Provides a process with an I/O channel.
 
Provides a process with an I/O channel.
==== parameters ====
+
<br>''parameters''<br>
 
* <code>devnam:str</code> name of the device
 
* <code>devnam:str</code> name of the device
 
* <code>acmode:int</code> access mode to be associated with the channel
 
* <code>acmode:int</code> access mode to be associated with the channel
 
* <code>mbxnam:str</code> logical name of the mailbox to be associated with the device
 
* <code>mbxnam:str</code> logical name of the mailbox to be associated with the device
 
* <code>flags:int</code> an optional device-specific argument
 
* <code>flags:int</code> an optional device-specific argument
==== returns ====
+
<br>''returns''<br>
 
The list:
 
The list:
 
* <code>int</code> status code of the operation
 
* <code>int</code> status code of the operation
Line 377: Line 377:
 
=== dassgn(channel:int)->int ===
 
=== dassgn(channel:int)->int ===
 
Unassigns (releases) an I/O channel.
 
Unassigns (releases) an I/O channel.
==== parameters ====
+
<br>''parameters''<br>
 
* <code>channel:int</code> number of the I/O channel to be unassigned
 
* <code>channel:int</code> number of the I/O channel to be unassigned
==== returns ====
+
<br>''returns''<br>
 
Status code
 
Status code
  
 
=== readvblk(channel:int, max_read:int, block:int, fmod:int)->list ===
 
=== readvblk(channel:int, max_read:int, block:int, fmod:int)->list ===
 
Read from I/O channel.
 
Read from I/O channel.
==== parameters ====
+
<br>''parameters''<br>
 
* <code>channel:int</code> I/O channel
 
* <code>channel:int</code> I/O channel
 
* <code>max_read:int</code> amount of bytes to read
 
* <code>max_read:int</code> amount of bytes to read
 
* <code>block:int</code> starting block
 
* <code>block:int</code> starting block
 
* <code>fmod:int</code> function code modifiers
 
* <code>fmod:int</code> function code modifiers
==== returns ====
+
<br>''returns''<br>
 
The list:
 
The list:
 
* <code>int</code> status code of the operation
 
* <code>int</code> status code of the operation
Line 397: Line 397:
 
=== writevblk(channel:int, buffer:bytes, block:int, fmod:int)->list ===
 
=== writevblk(channel:int, buffer:bytes, block:int, fmod:int)->list ===
 
Write to I/O channel.
 
Write to I/O channel.
==== parameters ====
+
<br>''parameters''<br>
 
* <code>channel:int</code> I/O channel
 
* <code>channel:int</code> I/O channel
 
* <code>buffer:bytes</code> bytes to write
 
* <code>buffer:bytes</code> bytes to write
 
* <code>block:int</code> starting block
 
* <code>block:int</code> starting block
 
* <code>fmod:int</code> function code modifiers
 
* <code>fmod:int</code> function code modifiers
==== returns ====
+
<br>''returns''<br>
 
The list:
 
The list:
 
* <code>int</code> status code of the operation
 
* <code>int</code> status code of the operation
Line 410: Line 410:
 
=== cancel(channel:int)->int ===
 
=== cancel(channel:int)->int ===
 
Cancel I/O operation.
 
Cancel I/O operation.
==== parameters ====
+
<br>''parameters''<br>
 
* <code>channel:int</code> I/O channel
 
* <code>channel:int</code> I/O channel
==== returns ====
+
<br>''returns''<br>
 
Status code
 
Status code
  
 
=== crelnm(attr:int, tabnam:str, lognam:str, acmode:int, il:object)->int ===
 
=== crelnm(attr:int, tabnam:str, lognam:str, acmode:int, il:object)->int ===
 
Creates a logical name and specifies its equivalence names.  
 
Creates a logical name and specifies its equivalence names.  
==== parameters ====
+
<br>''parameters''<br>
 
* <code>attr:int</code> attributes to be associated with the logical name. See '''vms.lnmdef'''
 
* <code>attr:int</code> attributes to be associated with the logical name. See '''vms.lnmdef'''
 
* <code>tabnam:str</code> name of the table in which to create the logical name
 
* <code>tabnam:str</code> name of the table in which to create the logical name
Line 424: Line 424:
 
* <code>il:object</code> item list, created via [[VMS specific Python modules#new()->object|<code>vms.ile3.new()</code>]]
 
* <code>il:object</code> item list, created via [[VMS specific Python modules#new()->object|<code>vms.ile3.new()</code>]]
 
See '''OpenVMS System Services Reference Manual''' for SYS$CRELNM.
 
See '''OpenVMS System Services Reference Manual''' for SYS$CRELNM.
==== returns ====
+
<br>''returns''<br>
 
Status code
 
Status code
  
 
=== trnlnm(attr:int, tabnam:str, lognam:str, acmode:int, il:object)->int ===
 
=== trnlnm(attr:int, tabnam:str, lognam:str, acmode:int, il:object)->int ===
 
Returns information about the specified logical name.
 
Returns information about the specified logical name.
==== parameters ====
+
<br>''parameters''<br>
 
* <code>attr:int</code> attributes controlling the search for the logical name. See '''vms.lnmdef'''
 
* <code>attr:int</code> attributes controlling the search for the logical name. See '''vms.lnmdef'''
 
* <code>tabnam:str</code> name of the logical name table or the name of a searchlist logical name
 
* <code>tabnam:str</code> name of the logical name table or the name of a searchlist logical name
Line 436: Line 436:
 
* <code>il:object</code> item list, created via [[VMS specific Python modules#new()->object|<code>vms.ile3.new()</code>]]
 
* <code>il:object</code> item list, created via [[VMS specific Python modules#new()->object|<code>vms.ile3.new()</code>]]
 
See '''OpenVMS System Services Reference Manual''' for SYS$TRNLNM.
 
See '''OpenVMS System Services Reference Manual''' for SYS$TRNLNM.
==== returns ====
+
<br>''returns''<br>
 
Status code
 
Status code
  
 
=== dellnm(tabnam:str, lognam:str, acmode:int)->int ===
 
=== dellnm(tabnam:str, lognam:str, acmode:int)->int ===
 
Deletes all logical names with the specified name.
 
Deletes all logical names with the specified name.
==== parameters ====
+
<br>''parameters''<br>
 
* <code>tabnam:str</code> name of the logical name table or the name of a searchlist logical name
 
* <code>tabnam:str</code> name of the logical name table or the name of a searchlist logical name
 
* <code>lognam:str</code> logical name to be deleted
 
* <code>lognam:str</code> logical name to be deleted
 
* <code>acmode:int</code> access mode to be used in the delete operation. See '''vms.psldef'''
 
* <code>acmode:int</code> access mode to be used in the delete operation. See '''vms.psldef'''
==== returns ====
+
<br>''returns''<br>
 
Status code
 
Status code
  
 
=== device_scan(search_devnam:str, item_list:object, context:int)->list ===
 
=== device_scan(search_devnam:str, item_list:object, context:int)->list ===
 
Returns the names of all devices that match a specified set of search criteria.
 
Returns the names of all devices that match a specified set of search criteria.
==== parameters ====
+
<br>''parameters''<br>
 
* <code>search_devnam:str</code> name of the device for which <code>device_scan</code> to search
 
* <code>search_devnam:str</code> name of the device for which <code>device_scan</code> to search
 
* <code>item_list:object</code> item list specifying search criteria
 
* <code>item_list:object</code> item list specifying search criteria
 
* <code>context:int</code> value used to indicate the current position of the search. On the initial call it must contain <code>0</code>.
 
* <code>context:int</code> value used to indicate the current position of the search. On the initial call it must contain <code>0</code>.
 
See '''OpenVMS System Services Reference Manual''' for SYS$DEVICE_SCAN
 
See '''OpenVMS System Services Reference Manual''' for SYS$DEVICE_SCAN
==== returns ====
+
<br>''returns''<br>
 
The list:
 
The list:
 
* <code>int</code> status code of the operation
 
* <code>int</code> status code of the operation
Line 463: Line 463:
 
=== uicstr(uic:int, flags:int)->list ===
 
=== uicstr(uic:int, flags:int)->list ===
 
Converts UIC to a string.
 
Converts UIC to a string.
==== parameters ====
+
<br>''parameters''<br>
 
* <code>uic:int</code> UIC
 
* <code>uic:int</code> UIC
 
* <code>flags:int</code>  
 
* <code>flags:int</code>  
 
** <code>0</code> - use "!%I" SYS$FAO format
 
** <code>0</code> - use "!%I" SYS$FAO format
 
** <code>1</code> - use "!%U" SYS$FAO format
 
** <code>1</code> - use "!%U" SYS$FAO format
==== returns ====
+
<br>''returns''<br>
 
The list:
 
The list:
 
* <code>int</code> status code of the operation
 
* <code>int</code> status code of the operation
Line 475: Line 475:
 
=== getdvi(dev_nam:str, item_list:object)->int ===
 
=== getdvi(dev_nam:str, item_list:object)->int ===
 
Returns information related to the primary and secondary device characteristics of an I/O device.
 
Returns information related to the primary and secondary device characteristics of an I/O device.
==== parameters ====
+
<br>''parameters''<br>
 
* <code>dev_nam:str</code> the name of the device for which information is to be returned
 
* <code>dev_nam:str</code> the name of the device for which information is to be returned
 
* <code>item_list:object</code> item list specifying which information about the device is to be returned.
 
* <code>item_list:object</code> item list specifying which information about the device is to be returned.
 
See '''OpenVMS System Services Reference Manual''' for SYS$GETDVI
 
See '''OpenVMS System Services Reference Manual''' for SYS$GETDVI
==== returns ====
+
<br>''returns''<br>
 
Status code
 
Status code
  
 
=== getjpi(pid:int, pnam:str, item_list:object)->list ===
 
=== getjpi(pid:int, pnam:str, item_list:object)->list ===
 
Returns information about one or more processes of the system or across the OpenVMS Cluster system.
 
Returns information about one or more processes of the system or across the OpenVMS Cluster system.
==== parameters ====
+
<br>''parameters''<br>
 
* <code>pid:int</code> process identification
 
* <code>pid:int</code> process identification
 
* <code>pnam:str</code> name of the process
 
* <code>pnam:str</code> name of the process
 
* <code>item_list:object</code> item list specifying which information about the process or processes is to be returned
 
* <code>item_list:object</code> item list specifying which information about the process or processes is to be returned
 
See '''OpenVMS System Services Reference Manual''' for SYS$GETJPI
 
See '''OpenVMS System Services Reference Manual''' for SYS$GETJPI
==== returns ====
+
<br>''returns''<br>
 
The list:
 
The list:
 
* <code>int</code> status code of the operation
 
* <code>int</code> status code of the operation
Line 496: Line 496:
 
=== getlki(lki:int, item_list:object)->list ===
 
=== getlki(lki:int, item_list:object)->list ===
 
Returns information about the lock database on a system.
 
Returns information about the lock database on a system.
==== parameters ====
+
<br>''parameters''<br>
 
* <code>lki:int</code> identification of the lock (lock ID) information about which needs to be returned
 
* <code>lki:int</code> identification of the lock (lock ID) information about which needs to be returned
 
* <code>item_list:object</code> item list specifying the lock information to be returned
 
* <code>item_list:object</code> item list specifying the lock information to be returned
 
See '''OpenVMS System Services Reference Manual''' for SYS$GETLKI
 
See '''OpenVMS System Services Reference Manual''' for SYS$GETLKI
==== returns ====
+
<br>''returns''<br>
 
The list:
 
The list:
 
* <code>int</code> status code of the operation
 
* <code>int</code> status code of the operation
Line 507: Line 507:
 
=== getmsg(msgid:int, flags:int)->list ===
 
=== getmsg(msgid:int, flags:int)->list ===
 
Returns message text associated with a given message identification code.
 
Returns message text associated with a given message identification code.
==== parameters ====
+
<br>''parameters''<br>
 
* <code>msgid:int</code> identification of the message to be retrieved
 
* <code>msgid:int</code> identification of the message to be retrieved
 
* <code>flags:int</code> message components to be returned
 
* <code>flags:int</code> message components to be returned
 
See '''OpenVMS System Services Reference Manual''' for SYS$GETMSG
 
See '''OpenVMS System Services Reference Manual''' for SYS$GETMSG
==== returns ====
+
<br>''returns''<br>
 
The list:
 
The list:
 
* <code>int</code> status code of the operation
 
* <code>int</code> status code of the operation
Line 519: Line 519:
 
=== getqui(func:int, context:int, item_list:object)->list ===
 
=== getqui(func:int, context:int, item_list:object)->list ===
 
Returns information about queues and the jobs initiated from these queues.
 
Returns information about queues and the jobs initiated from these queues.
==== parameters ====
+
<br>''parameters''<br>
 
* <code>func:int</code> function code specifying the function that <code>getqui</code> is to perform. See '''vms.quidef'''
 
* <code>func:int</code> function code specifying the function that <code>getqui</code> is to perform. See '''vms.quidef'''
 
* <code>context:int</code> context stream for this call
 
* <code>context:int</code> context stream for this call
 
* <code>item_list:object</code> item list supplying the information to be used by the function  
 
* <code>item_list:object</code> item list supplying the information to be used by the function  
 
See '''OpenVMS System Services Reference Manual''' for SYS$GETQUI
 
See '''OpenVMS System Services Reference Manual''' for SYS$GETQUI
==== returns ====
+
<br>''returns''<br>
 
The list:
 
The list:
 
* <code>int</code> status code of the operation
 
* <code>int</code> status code of the operation
Line 531: Line 531:
 
=== getrmi(item_list:object)->int ===
 
=== getrmi(item_list:object)->int ===
 
Returns system performance information about the local system.
 
Returns system performance information about the local system.
==== parameters ====
+
<br>''parameters''<br>
 
* <code>item_list:object</code> item list specifying which information about the local node is to be returned
 
* <code>item_list:object</code> item list specifying which information about the local node is to be returned
 
See '''OpenVMS System Services Reference Manual''' for SYS$GETRMI
 
See '''OpenVMS System Services Reference Manual''' for SYS$GETRMI
==== returns ====
+
<br>''returns''<br>
 
Status code
 
Status code
  
 
=== getsyi(csid:int, node_name:str, item_list:object)->list ===
 
=== getsyi(csid:int, node_name:str, item_list:object)->list ===
 
Returns information about the local system or about other systems in an OpenVMS Cluster system.
 
Returns information about the local system or about other systems in an OpenVMS Cluster system.
==== parameters ====
+
<br>''parameters''<br>
 
* <code>csid:int</code> OpenVMS Cluster system identification
 
* <code>csid:int</code> OpenVMS Cluster system identification
 
* <code>node_name:str</code> name of the node about which information is to be returned
 
* <code>node_name:str</code> name of the node about which information is to be returned
 
* <code>item_list:object</code> item list specifying which information about the node or nodes to return
 
* <code>item_list:object</code> item list specifying which information about the node or nodes to return
 
See '''OpenVMS System Services Reference Manual''' for SYS$GETSYI
 
See '''OpenVMS System Services Reference Manual''' for SYS$GETSYI
==== returns ====
+
<br>''returns''<br>
 
The list:
 
The list:
 
* <code>int</code> status code of the operation
 
* <code>int</code> status code of the operation
Line 551: Line 551:
 
=== gettim()->list ===
 
=== gettim()->list ===
 
Returns the current system time in a 64-bit format.
 
Returns the current system time in a 64-bit format.
==== parameters ====
+
<br>''parameters''<br>
 
<code>None</code>
 
<code>None</code>
==== returns ====
+
<br>''returns''<br>
 
The list:
 
The list:
 
* <code>int</code> status code of the operation
 
* <code>int</code> status code of the operation
Line 560: Line 560:
 
=== getuai(user_name:str, item_list:object)->int ===
 
=== getuai(user_name:str, item_list:object)->int ===
 
Returns authorization information about the specified user.
 
Returns authorization information about the specified user.
==== parameters ====
+
<br>''parameters''<br>
 
* <code>user_name:str</code> name of the user to get authorization information for
 
* <code>user_name:str</code> name of the user to get authorization information for
 
* <code>item_list:object</code> item list specifying which information to return
 
* <code>item_list:object</code> item list specifying which information to return
 
See '''OpenVMS System Services Reference Manual''' for SYS$GETUAI
 
See '''OpenVMS System Services Reference Manual''' for SYS$GETUAI
==== returns ====
+
<br>''returns''<br>
 
Status code
 
Status code
  
 
=== hiber()->int ===
 
=== hiber()->int ===
 
Allows a process to make itself inactive but to remain known to the system so that it can be interrupted.
 
Allows a process to make itself inactive but to remain known to the system so that it can be interrupted.
==== parameters ====
+
<br>''parameters''<br>
 
<code>None</code>
 
<code>None</code>
==== returns ====
+
<br>''returns''<br>
 
Status code
 
Status code
  
 
=== schdwk(pid:int, pname:str, time:int)->list ===
 
=== schdwk(pid:int, pname:str, time:int)->list ===
 
Schedules the awakening (restart) of a process that has placed itself in the state of hibernation with the Hibernate service.
 
Schedules the awakening (restart) of a process that has placed itself in the state of hibernation with the Hibernate service.
==== parameters ====
+
<br>''parameters''<br>
 
* <code>pid:int</code> process identification (PID) of the process to be awakened
 
* <code>pid:int</code> process identification (PID) of the process to be awakened
 
* <code>pname:str</code> name of the process to be awakened
 
* <code>pname:str</code> name of the process to be awakened
 
* <code>time:int</code> time at which the process to be awakened
 
* <code>time:int</code> time at which the process to be awakened
 
See '''OpenVMS System Services Reference Manual''' for SYS$SCHDWK
 
See '''OpenVMS System Services Reference Manual''' for SYS$SCHDWK
==== returns ====
+
<br>''returns''<br>
 
The list:
 
The list:
 
* <code>int</code> status code of the operation
 
* <code>int</code> status code of the operation
Line 588: Line 588:
 
=== add_holder(id:int, holder:int, attrib:int)->int ===
 
=== add_holder(id:int, holder:int, attrib:int)->int ===
 
Adds a specified holder record to a target identifier.
 
Adds a specified holder record to a target identifier.
==== parameters ====
+
<br>''parameters''<br>
 
* <code>id:int</code> target identifier granted to the specified holder
 
* <code>id:int</code> target identifier granted to the specified holder
 
* <code>holder:int</code> holder identifier that is granted access to the target identifier
 
* <code>holder:int</code> holder identifier that is granted access to the target identifier
 
* <code>attrib:int</code> attributes to be placed in the holder record
 
* <code>attrib:int</code> attributes to be placed in the holder record
 
See '''OpenVMS System Services Reference Manual''' for SYS$ADD_HOLDER
 
See '''OpenVMS System Services Reference Manual''' for SYS$ADD_HOLDER
==== returns ====
+
<br>''returns''<br>
 
Status code
 
Status code
  
 
=== add_ident(name:str, id:int, attrib:int)->list ===
 
=== add_ident(name:str, id:int, attrib:int)->list ===
 
Adds the specified identifier to the rights database.
 
Adds the specified identifier to the rights database.
==== parameters ====
+
<br>''parameters''<br>
 
* <code>name:str</code> identifier name to be added to the rights database
 
* <code>name:str</code> identifier name to be added to the rights database
 
* <code>id:int</code> identifier to be created
 
* <code>id:int</code> identifier to be created
 
* <code>attrib:int</code> attributes placed in the identifier’s record
 
* <code>attrib:int</code> attributes placed in the identifier’s record
 
See '''OpenVMS System Services Reference Manual''' for SYS$ADD_IDENT
 
See '''OpenVMS System Services Reference Manual''' for SYS$ADD_IDENT
==== returns ====
+
<br>''returns''<br>
 
The list:
 
The list:
 
* <code>int</code> status code of the operation
 
* <code>int</code> status code of the operation
Line 610: Line 610:
 
=== find_held(holder:int, context:int)->list ===
 
=== find_held(holder:int, context:int)->list ===
 
Returns the identifiers held by the specified holder.
 
Returns the identifiers held by the specified holder.
==== parameters ====
+
<br>''parameters''<br>
 
* <code>holder:int</code> holder whose identifiers to be found
 
* <code>holder:int</code> holder whose identifiers to be found
 
* <code>context:int</code> context value used when <code>find_held</code> is called repeatedly
 
* <code>context:int</code> context value used when <code>find_held</code> is called repeatedly
 
See '''OpenVMS System Services Reference Manual''' for SYS$FIND_HELD
 
See '''OpenVMS System Services Reference Manual''' for SYS$FIND_HELD
==== returns ====
+
<br>''returns''<br>
 
The list:
 
The list:
 
* <code>int</code> status code of the operation
 
* <code>int</code> status code of the operation
Line 623: Line 623:
 
=== finish_rdb(context:int)->int ===
 
=== finish_rdb(context:int)->int ===
 
Deallocates the record stream and clears the context value.
 
Deallocates the record stream and clears the context value.
==== parameters ====
+
<br>''parameters''<br>
 
* <code>context:int</code> context value to be cleared
 
* <code>context:int</code> context value to be cleared
==== returns ====
+
<br>''returns''<br>
 
Status code
 
Status code
  
 
=== forcex(pid:int, pname:str, code:int)->int ===
 
=== forcex(pid:int, pname:str, code:int)->int ===
 
Causes an Exit ($EXIT) service call to be issued on behalf of a specified process.
 
Causes an Exit ($EXIT) service call to be issued on behalf of a specified process.
==== parameters ====
+
<br>''parameters''<br>
 
* <code>pid:int</code> process identification (PID) of the process to force exit
 
* <code>pid:int</code> process identification (PID) of the process to force exit
 
* <code>pname:str</code> process name of the process that is to force exit
 
* <code>pname:str</code> process name of the process that is to force exit
 
* <code>code:int</code> completion code value to be used as the exit parameter
 
* <code>code:int</code> completion code value to be used as the exit parameter
==== returns ====
+
<br>''returns''<br>
 
Status code
 
Status code
  
 
=== rem_holder(id:int, holder:int)->int ===
 
=== rem_holder(id:int, holder:int)->int ===
 
Deletes the specified holder record from the target identifier’s list of holders.
 
Deletes the specified holder record from the target identifier’s list of holders.
==== parameters ====
+
<br>''parameters''<br>
 
* <code>id:int</code> binary value of the target identifier
 
* <code>id:int</code> binary value of the target identifier
 
* <code>holder:int</code> identifier of the holder being deleted
 
* <code>holder:int</code> identifier of the holder being deleted
==== returns ====
+
<br>''returns''<br>
 
Status code
 
Status code
  
 
=== rem_ident(id:int)->int ===
 
=== rem_ident(id:int)->int ===
 
Removes the specified identifier record and all its holder records (if any) from the rights database.  
 
Removes the specified identifier record and all its holder records (if any) from the rights database.  
==== parameters ====
+
<br>''parameters''<br>
 
* <code>id:int</code> binary value of the identifier deleted from rights database
 
* <code>id:int</code> binary value of the identifier deleted from rights database
==== returns ====
+
<br>''returns''<br>
 
Status code
 
Status code
  
 
=== setuai(user_name:str, item_list:object)->int ===
 
=== setuai(user_name:str, item_list:object)->int ===
 
Modifies the user authorization file (UAF) record for the specified user.
 
Modifies the user authorization file (UAF) record for the specified user.
==== parameters ====
+
<br>''parameters''<br>
 
* <code>user_name:str</code> name of the user whose UAF record is modified
 
* <code>user_name:str</code> name of the user whose UAF record is modified
 
* <code>item_list:object</code> item list specifying which information from the specified UAF record is to be modified
 
* <code>item_list:object</code> item list specifying which information from the specified UAF record is to be modified
 
See '''OpenVMS System Services Reference Manual''' for SYS$SETUAI
 
See '''OpenVMS System Services Reference Manual''' for SYS$SETUAI
==== returns ====
+
<br>''returns''<br>
 
Status code
 
Status code
  
 
=== show_intrusion(user_criteria:str, flags:int, context:int)->list ===
 
=== show_intrusion(user_criteria:str, flags:int, context:int)->list ===
 
Searches for and returns information about records in the intrusion database matching the caller specifications.
 
Searches for and returns information about records in the intrusion database matching the caller specifications.
==== parameters ====
+
<br>''parameters''<br>
 
* <code>user_criteria:str</code> description of an intruder or suspect
 
* <code>user_criteria:str</code> description of an intruder or suspect
 
* <code>flags:int</code> type of records in the intrusion database about which information is to be returned. NOTE: do not use '''vms.ciadef.CIA_M_ITEMLIST''', because <code>user_criteria</code> is a string
 
* <code>flags:int</code> type of records in the intrusion database about which information is to be returned. NOTE: do not use '''vms.ciadef.CIA_M_ITEMLIST''', because <code>user_criteria</code> is a string
 
* <code>context:int</code> context information to keep between related calls
 
* <code>context:int</code> context information to keep between related calls
 
See '''OpenVMS System Services Reference Manual''' for SYS$SETUAI
 
See '''OpenVMS System Services Reference Manual''' for SYS$SETUAI
==== returns ====
+
<br>''returns''<br>
 
The list:
 
The list:
 
* <code>int</code> status code of the operation
 
* <code>int</code> status code of the operation
Line 681: Line 681:
 
=== Attach(dbname:string)->int ===
 
=== Attach(dbname:string)->int ===
 
Attaches to the specified database. The string may specify the full path to the RDB database in OpenVMS format or (more commonly) a logical name pointing to the database.
 
Attaches to the specified database. The string may specify the full path to the RDB database in OpenVMS format or (more commonly) a logical name pointing to the database.
==== parameters ====
+
<br>''parameters''<br>
 
* <code>dbname:string</code> path or logical name
 
* <code>dbname:string</code> path or logical name
==== returns ====
+
<br>''returns''<br>
 
Status code:
 
Status code:
 
* <code>0</code> success
 
* <code>0</code> success
Line 690: Line 690:
 
=== CloseCursor(cursor:object)->int ===  
 
=== CloseCursor(cursor:object)->int ===  
 
Closes the specified cursor.
 
Closes the specified cursor.
==== parameters ====
+
<br>''parameters''<br>
 
* <code>cursor:object</code> cursor
 
* <code>cursor:object</code> cursor
==== returns ====
+
<br>''returns''<br>
 
Status code:
 
Status code:
 
* <code>0</code> success
 
* <code>0</code> success
Line 699: Line 699:
 
=== Commit()->int ===
 
=== Commit()->int ===
 
Commits the current database transaction.
 
Commits the current database transaction.
==== parameters ====
+
<br>''parameters''<br>
 
<code>None</code>
 
<code>None</code>
==== returns ====
+
<br>''returns''<br>
 
Status code:
 
Status code:
 
* <code>0</code> success
 
* <code>0</code> success
Line 708: Line 708:
 
=== Data(cursor:object, idx:int)->str ===
 
=== Data(cursor:object, idx:int)->str ===
 
Given a cursor handle and column index (integer), returns the data value for the specified column for the last fetch operation.
 
Given a cursor handle and column index (integer), returns the data value for the specified column for the last fetch operation.
==== parameters ====
+
<br>''parameters''<br>
 
* <code>cursor:object</code> cursor
 
* <code>cursor:object</code> cursor
 
* <code>idx:int</code> index
 
* <code>idx:int</code> index
==== returns ====
+
<br>''returns''<br>
 
Resulting string
 
Resulting string
  
 
=== DeclareCursor(name:str, statement:str)->object ===
 
=== DeclareCursor(name:str, statement:str)->object ===
 
Declares a cursor. Inputs are the name for the cursor and the SQL statement. On success the function returns a cursor handle that can be used with <code>OpenCursor()</code>, <code>FetchCursor()</code>, and <code>CloseCursor()</code>.
 
Declares a cursor. Inputs are the name for the cursor and the SQL statement. On success the function returns a cursor handle that can be used with <code>OpenCursor()</code>, <code>FetchCursor()</code>, and <code>CloseCursor()</code>.
==== parameters ====
+
<br>''parameters''<br>
 
* <code>name:str</code> name for the cursor
 
* <code>name:str</code> name for the cursor
 
* <code>statement:str</code> SQL statement
 
* <code>statement:str</code> SQL statement
==== returns ====
+
<br>''returns''<br>
 
Resulting cursor
 
Resulting cursor
  
 
=== Detach()->int ===
 
=== Detach()->int ===
 
Disconnects from the database.
 
Disconnects from the database.
==== parameters ====
+
<br>''parameters''<br>
 
<code>None</code>
 
<code>None</code>
==== returns ====
+
<br>''returns''<br>
 
Status code:
 
Status code:
 
* <code>0</code> success
 
* <code>0</code> success
Line 733: Line 733:
 
=== Error()->str ===
 
=== Error()->str ===
 
Returns a description of the last error.
 
Returns a description of the last error.
==== parameters ====
+
<br>''parameters''<br>
 
<code>None</code>
 
<code>None</code>
==== returns ====
+
<br>''returns''<br>
 
Resulting error string
 
Resulting error string
  
 
=== Exec(sh:object)->int ===
 
=== Exec(sh:object)->int ===
 
Executes a previously prepared SQL statement.
 
Executes a previously prepared SQL statement.
==== parameters ====
+
<br>''parameters''<br>
 
* <code>sh:object</code> prepared SQL statement
 
* <code>sh:object</code> prepared SQL statement
==== returns ====
+
<br>''returns''<br>
 
Status code:
 
Status code:
 
* <code>0</code> success
 
* <code>0</code> success
Line 750: Line 750:
 
Executes the supplied SQL statement immediately.<br>
 
Executes the supplied SQL statement immediately.<br>
 
     '''Note: the last letter is a capital 'i'
 
     '''Note: the last letter is a capital 'i'
==== parameters ====
+
<br>''parameters''<br>
 
* <code>st:str</code> SQL statement
 
* <code>st:str</code> SQL statement
==== returns ====
+
<br>''returns''<br>
 
Status code:
 
Status code:
 
* <code>0</code> success
 
* <code>0</code> success
Line 759: Line 759:
 
=== Fetch(cursor:object)->int ===
 
=== Fetch(cursor:object)->int ===
 
Fetches a row of data for the specified cursor but does not explicitly return the fetched data. The <code>Data()</code> method can then be used to retrieve individual data values for each column (<code>Ncol()</code> can be used to determine the number of columns).
 
Fetches a row of data for the specified cursor but does not explicitly return the fetched data. The <code>Data()</code> method can then be used to retrieve individual data values for each column (<code>Ncol()</code> can be used to determine the number of columns).
==== parameters ====
+
<br>''parameters''<br>
 
* <code>cursor:object</code> cursor
 
* <code>cursor:object</code> cursor
==== returns ====
+
<br>''returns''<br>
 
Status code:
 
Status code:
 
* <code>1</code> success
 
* <code>1</code> success
Line 769: Line 769:
 
=== FetchRow(cursor:object)->list ===
 
=== FetchRow(cursor:object)->list ===
 
Fetches a row of data using the specified cursor handle. The fetched data is returned as an list of strings.
 
Fetches a row of data using the specified cursor handle. The fetched data is returned as an list of strings.
==== parameters ====
+
<br>''parameters''<br>
 
* <code>cursor:object</code> cursor
 
* <code>cursor:object</code> cursor
==== returns ====
+
<br>''returns''<br>
 
The list of strings
 
The list of strings
  
 
=== Free(cursor:object)->int ===
 
=== Free(cursor:object)->int ===
 
Frees resources associated with the supplied cursor handle for a cursor previously declared via <code>DeclareCursor()</code>.
 
Frees resources associated with the supplied cursor handle for a cursor previously declared via <code>DeclareCursor()</code>.
==== parameters ====
+
<br>''parameters''<br>
 
* <code>cursor:object</code> cursor
 
* <code>cursor:object</code> cursor
==== returns ====
+
<br>''returns''<br>
 
Status code:
 
Status code:
 
* <code>0</code> success
 
* <code>0</code> success
Line 784: Line 784:
 
=== Ncol(cursor:object)->int ===
 
=== Ncol(cursor:object)->int ===
 
Returns the number of columns (values) that would be returned by a fetch for the specified cursor.
 
Returns the number of columns (values) that would be returned by a fetch for the specified cursor.
==== parameters ====
+
<br>''parameters''<br>
 
* <code>cursor:object</code> cursor
 
* <code>cursor:object</code> cursor
==== returns ====
+
<br>''returns''<br>
 
Number of columns
 
Number of columns
  
 
=== OpenCursor(cursor:object)->int ===
 
=== OpenCursor(cursor:object)->int ===
 
Opens a cursor using the supplied (previously declared) cursor handle.
 
Opens a cursor using the supplied (previously declared) cursor handle.
==== parameters ====
+
<br>''parameters''<br>
 
* <code>cursor:object</code> cursor
 
* <code>cursor:object</code> cursor
==== returns ====
+
<br>''returns''<br>
 
Status code:
 
Status code:
 
* <code>0</code> success
 
* <code>0</code> success
Line 800: Line 800:
 
=== Prepare(st:string)->object ===
 
=== Prepare(st:string)->object ===
 
Prepares an SQL statement and returns a handle for the prepared statement that can be used in subsequent calls to Exec().
 
Prepares an SQL statement and returns a handle for the prepared statement that can be used in subsequent calls to Exec().
==== parameters ====
+
<br>''parameters''<br>
 
* <code>st:string</code> SQL statement
 
* <code>st:string</code> SQL statement
==== returns ====
+
<br>''returns''<br>
 
Resulting prepared statement
 
Resulting prepared statement
  
 
=== Rollback()->int ===
 
=== Rollback()->int ===
 
Rolls back the current database transaction.
 
Rolls back the current database transaction.
==== parameters ====
+
<br>''parameters''<br>
 
<code>None</code>
 
<code>None</code>
==== returns ====
+
<br>''returns''<br>
 
Status code:
 
Status code:
 
* <code>0</code> success
 
* <code>0</code> success
Line 816: Line 816:
 
=== SetReadonly()->int ===
 
=== SetReadonly()->int ===
 
Starts a read-only transaction.
 
Starts a read-only transaction.
==== parameters ====
+
<br>''parameters''<br>
 
<code>None</code>
 
<code>None</code>
==== returns ====
+
<br>''returns''<br>
 
Status code:
 
Status code:
 
* <code>0</code> success
 
* <code>0</code> success
Line 825: Line 825:
 
=== Sqlcode()->int ===
 
=== Sqlcode()->int ===
 
Returns the SQLCODE for the last database operation.
 
Returns the SQLCODE for the last database operation.
==== parameters ====
+
<br>''parameters''<br>
 
<code>None</code>
 
<code>None</code>
==== returns ====
+
<br>''returns''<br>
 
Resulting SQL code
 
Resulting SQL code

Revision as of 05:15, 1 September 2020

VMS specific Python modules.

Contents

vms.decc

Wraps the C Run-Time Library for OpenVMS Systems functions.

dlopen_test(name:str)->int

Tries to open a shared image.
parameters

  • name:str path to the shared image


returns

  • 1 if the shared image exists and can be opened by dlopen()
  • 0 otherwise

fix_time(vms_time:int)->int

Converts VMS time to the Unix time.
parameters

  • vms_time:int VMS system time


returns
Time in Unix format (seconds that have elapsed since 1970.01.01)

from_vms(vms_path:str, wild_flag:int)->list

Converts VMS path to a list of Unix paths.
parameters

  • vms_path:str path in VMS format (supports wildcards)
  • wild_flag:int If set to 0, wildcards found in the vms_path are not expanded


returns
List of paths in Unix format

getenv(name:str, def_value:str)->str

Gets the specified environment variable value. See getenv() description in the C Run-Time Library Reference Manual for OpenVMS Systems documentation.
parameters

  • name:str name of the environment variable
  • def_value:str default value


returns
Environment variable value

sleep(seconds:int)->int

Suspends execution of the current process or thread for the specified number of seconds.
parameters

  • seconds:int seconds to sleep


returns
The number of seconds left to the end of the sleep period if sleep is interrupted. 0 if the process slept for the specified number of seconds.

sysconf(name:int)->int

Provides a method for determining the current value of a configurable system limit or whether optional features are supported.
parameters

  • name:int system variable to be queried


returns
Requested value

to_vms(unix_path:str, allow_wild:int, no_directory:int)->list

Converts UNIX style file specifications to OpenVMS file specifications.
parameters

  • unix_path:str file name in UNIX style file specification format
  • allow_wild:int If set to 0, wildcards found in unix_path are not expanded
  • no_directory:int An integer that has one of the following values:
    • 0 - Directory allowed
    • 1 - Prevent expansion of the string as a directory name
    • 2 - Force expansion of the string as a directory name


returns
List of paths in OpenVMS style

unixtime(vms_time:int)->int

Converts OpenVMS system time to the Unix local time.
parameters

  • vms_time:int OpenVMS system time


returns
Unix time

vmstime(unix_time:int)->int

Converts Unix time to the OpenVMS system time.
parameters

  • unix_time:int Unix time


returns
OpenVMS system time

vms.ile3

Provides functions for working with the list.

new()->object

Creates empty item list.
parameters
None
returns
New empty item list

delete(il:object)->None

Deletes item list.
parameters

  • il:object item list to be removed


returns
OpenVMS system time

size(il:object)->int

Gets size of the item list.
parameters

  • il:object item list


returns
The size of the specified item list

addint(il:object, item:int, item_type:int, item_value:int)->None

Adds a new integer to the item list.
parameters

  • il:object item list
  • item:int item to add
  • item_type:int type of the item. See vms.dscdef
  • item_value:int value of the item


returns
None

getint(il:object, index:int)->int

Gets the integer at the specified index in the list.
parameters

  • il:object item list
  • index:int index of the item to get


returns
Integer value

gethex(il:object, index:int)->str

Gets the integer at the specified index in the item list and returns it as a hexadecimal string.
parameters

  • il:object item list
  • index:int index of the item to get


returns
Hexadecimal string

addstr(il:object, item:int, item_value:str, item_length:int)->None

Adds the specified string to the item list. If the item_value is not None, the item_length is ignored and the length of the buffer will be the same as the length of the item_value.
parameters

  • il:object item list
  • item:int item to add
  • item_value:str value to add (or None)
  • item_length:int length of the buffer if the item_value is None


returns
None

addstrd(il:object, item:int, item_value:str, item_length:int)->None

Adds the specified space-expanded string to the item list. The first byte of the buffer is the length of the string. If the item_value is longer than the item_length, it will be truncated.
parameters

  • il:object item list
  • item:int item to add
  • item_value:str value to add
  • item_length:int length of the buffer (the resulting string length is one byte less)


returns
None

addstrn(il:object, item:int, item_value:str, item_length:int)->None

Adds the specified space-expanded string to the item list. If the item_value is longer than the item_length, it will be truncated.
parameters

  • il:object item list
  • item:int item to add
  • item_value:str value to add
  • item_length:int length of the buffer


returns
None

getstr(il:object, index:int, flag:int)->str

Gets the string at the specified index in the item list.
parameters

  • il:object item list
  • index:int index of the item to get
  • flag:int if set to 1, the first byte of the resulting string is the length of the string


returns
String

addbin(il:object, item:int, item_value:int, item_offset:int, item_len:int)->None

Adds a new binary item to the list. It will be interpreted as a string.
parameters

  • il:object item list
  • item:int item to add
  • item_value:int value to store
  • item_offset:int starting byte
  • item_len:int amount of bytes


returns
None

getbyte(il:object, index:int, item_offset:int)->int

Gets the byte at the specified position in the item list.
parameters

  • il:object item list
  • index:int index of the item
  • item_offset:int starting byte


returns
Integer value of the specified byte

vms.lib

Wraps the OpenVMS RTL Library(LIB$) functions.

create_dir(name:str, uic:int, pe:int, pv:int)->int

Creates a directory.
parameters

  • name:str name of the directory to be created (specified in OpenVMS style)
  • uic:int unsigned integer value of the owner UIC:
    • None - the current user
    • 0 - owner of the parent directory
  • pe:int protection enable. See full documentation in the OpenVMS RTL Library(LIB$) Manual for LIB$CREATE_DIR.
  • pv:int protection value


returns

  • vms.ssdef.SS__CREATED one or more directories created
  • vms.ssdef.SS__NORMAL all specified directories already exist
  • another error. See in vms.ssdef

date_time()->list

Gets current date and time.
parameters
None
returns
The list:

  • int status code of the operation
  • str resulting string

get_ef()->list

Allocates a local event flag.
parameters
None
returns
The list:

  • int status code of the operation
  • int resulting event flag

free_ef(ef:int)->int

Releases the local event flag.
parameters

  • ef:int the local event flag


returns
Status code of the operation

put_common(common:str)->int

Copies a string into the common area.
parameters

  • common:str string to copy


returns
Status code of the operation

get_common()->list

Gets the string from the common area.
parameters
None
returns
The list:

  • int status code of the operation
  • str resulting string

get_hostname(flags:int)->list

Gets the host name of the local system.
parameters

  • flags:int if set to 1, the host node name is returned in the parsable form


returns
The list:

  • int status code of the operation
  • str resulting host node name

getjpi(item_code:int, pid:int, pname:str)->list

Gets the specified job/process information as a string.
parameters

  • item_code:int item identifier code defining the item of information to be returned. See vms.jpidef
  • pid:int process id
  • pname:str process name

For valid combination of the values of pid and pname see the OpenVMS RTL Library(LIB$) Manual for LIB$GETJPI. The resulting pid is not returned.
returns
The list:

  • int status code of the operation
  • str resulting string

getsyi(item_code:int, node_name:str)->list

Gets system wide information as a string.
parameters

  • item_code:int item identifier code defining the item of information to be returned. See vms.syidef
  • node_name:str node name


returns
The list:

  • int status code of the operation
  • str resulting string
  • int resulting cluster system id

spawn(command:str, input_file:str, output_file:str, flags:int, pname:str)->list

Requests the command language interpreter (CLI) of the calling process to spawn a subprocess for executing CLI commands.
parameters

  • command:str command to execute
  • input_file:str equivalence name to be associated with the logical name SYS$INPUT
  • output_file:str equivalence name to be associated with the logical name SYS$OUTPUT
  • flags:int flag bits that designate optional behavior. See vms.clidef
  • pname:str name defined for the subprocess


returns
The list:

  • int status code of the operation
  • int process id of the spawned process

do_command(command:str)->None

Stops program execution and directs the command language interpreter (CLI) to execute a command that is supplied as the argument.
parameters

  • command:str command to execute


returns
If successful, it does not return control to the calling program.

vms.sys

Wraps the OpenVMS System Services functions.

asctim(vms_time:int, time_only:int)->list

Converts an absolute or delta time from 64-bit system time format to an ASCII string.
parameters

  • vms_time:int OpenVMS system time. A negative time value represents a delta time.
  • time_only:int if set to 1, asctim returns the hour only.


returns
The list:

  • int status code of the operation
  • str resulting string

bintim(time_str:str)->list

Converts an ASCII string to an absolute or delta time value in the system 64-bit time format.
parameters

  • time_str:str in format:
    • Absolute Time: dd-mmm-yyyy hh:mm:ss.cc
    • Delta Time: dddd hh:mm:ss.cc


returns
The list:

  • int status code of the operation
  • int resulting time value

asctoid(name:str)->list

Translates the specified identifier name into its binary identifier value.
parameters

  • name:str identifier name


returns
The list:

  • int status code of the operation
  • int resulting identifier value
  • int resulting identifier attributes. See vms.kgbdef

idtoasc(id_val:int, context:int)->list

Translates the specified identifier value to the identifier name.
parameters

  • id_val:int identifier value. See OpenVMS System Services Reference Manual for SYS$IDTOASC
  • context:int context value used when idtoasc is called repeatedly. Must be initialized with the value 0.


returns
The list:

  • int status code of the operation
  • str resulting identifier name
  • int resulting identifier value
  • int resulting identifier attributes. See vms.kgbdef
  • int resulting context

crembx(tmp:int, maxmsg:int, bufquo:int, promsk:int, acmode:int, mbx_name:string, flags:int)->list

Creates a virtual mailbox device.
parameters

  • tmp:int the first bit specifies a permanent mailbox
  • maxmsg:int maximum size of a message (in bytes)
  • bufquo:int number of bytes of system dynamic memory that can be used to buffer messages sent to the mailbox
  • promsk:int protection mask to be associated with the created mailbox
  • acmode:int access mode to be associated with the channel to which the mailbox is assigned
  • mbx_name:string logical name to be assigned to the mailbox
  • flags:int options for the assign operation. See vms.cmbdef


returns
The list:

  • int status code of the operation
  • int resulting channel

delmbx(channel:int)->int

Marks a permanent mailbox for deletion.
parameters

  • channel:int mailbox channel


returns
Status code

assign(devnam:str, acmode:int, mbxnam:str, flags:int)->list

Provides a process with an I/O channel.
parameters

  • devnam:str name of the device
  • acmode:int access mode to be associated with the channel
  • mbxnam:str logical name of the mailbox to be associated with the device
  • flags:int an optional device-specific argument


returns
The list:

  • int status code of the operation
  • int resulting channel

dassgn(channel:int)->int

Unassigns (releases) an I/O channel.
parameters

  • channel:int number of the I/O channel to be unassigned


returns
Status code

readvblk(channel:int, max_read:int, block:int, fmod:int)->list

Read from I/O channel.
parameters

  • channel:int I/O channel
  • max_read:int amount of bytes to read
  • block:int starting block
  • fmod:int function code modifiers


returns
The list:

  • int status code of the operation
  • byte resulting buffer
  • int I/O completion code

writevblk(channel:int, buffer:bytes, block:int, fmod:int)->list

Write to I/O channel.
parameters

  • channel:int I/O channel
  • buffer:bytes bytes to write
  • block:int starting block
  • fmod:int function code modifiers


returns
The list:

  • int status code of the operation
  • int amount of written bytes
  • int I/O completion code

cancel(channel:int)->int

Cancel I/O operation.
parameters

  • channel:int I/O channel


returns
Status code

crelnm(attr:int, tabnam:str, lognam:str, acmode:int, il:object)->int

Creates a logical name and specifies its equivalence names.
parameters

  • attr:int attributes to be associated with the logical name. See vms.lnmdef
  • tabnam:str name of the table in which to create the logical name
  • lognam:str logical name to be created
  • acmode:int access mode to be associated with the logical name. See vms.psldef
  • il:object item list, created via vms.ile3.new()

See OpenVMS System Services Reference Manual for SYS$CRELNM.
returns
Status code

trnlnm(attr:int, tabnam:str, lognam:str, acmode:int, il:object)->int

Returns information about the specified logical name.
parameters

  • attr:int attributes controlling the search for the logical name. See vms.lnmdef
  • tabnam:str name of the logical name table or the name of a searchlist logical name
  • lognam:str logical name for which information is to be returned
  • acmode:int access mode to be used in the translation. See vms.psldef
  • il:object item list, created via vms.ile3.new()

See OpenVMS System Services Reference Manual for SYS$TRNLNM.
returns
Status code

dellnm(tabnam:str, lognam:str, acmode:int)->int

Deletes all logical names with the specified name.
parameters

  • tabnam:str name of the logical name table or the name of a searchlist logical name
  • lognam:str logical name to be deleted
  • acmode:int access mode to be used in the delete operation. See vms.psldef


returns
Status code

device_scan(search_devnam:str, item_list:object, context:int)->list

Returns the names of all devices that match a specified set of search criteria.
parameters

  • search_devnam:str name of the device for which device_scan to search
  • item_list:object item list specifying search criteria
  • context:int value used to indicate the current position of the search. On the initial call it must contain 0.

See OpenVMS System Services Reference Manual for SYS$DEVICE_SCAN
returns
The list:

  • int status code of the operation
  • str found device name
  • int context

uicstr(uic:int, flags:int)->list

Converts UIC to a string.
parameters

  • uic:int UIC
  • flags:int
    • 0 - use "!%I" SYS$FAO format
    • 1 - use "!%U" SYS$FAO format


returns
The list:

  • int status code of the operation
  • str UIC string

getdvi(dev_nam:str, item_list:object)->int

Returns information related to the primary and secondary device characteristics of an I/O device.
parameters

  • dev_nam:str the name of the device for which information is to be returned
  • item_list:object item list specifying which information about the device is to be returned.

See OpenVMS System Services Reference Manual for SYS$GETDVI
returns
Status code

getjpi(pid:int, pnam:str, item_list:object)->list

Returns information about one or more processes of the system or across the OpenVMS Cluster system.
parameters

  • pid:int process identification
  • pnam:str name of the process
  • item_list:object item list specifying which information about the process or processes is to be returned

See OpenVMS System Services Reference Manual for SYS$GETJPI
returns
The list:

  • int status code of the operation
  • int process id

getlki(lki:int, item_list:object)->list

Returns information about the lock database on a system.
parameters

  • lki:int identification of the lock (lock ID) information about which needs to be returned
  • item_list:object item list specifying the lock information to be returned

See OpenVMS System Services Reference Manual for SYS$GETLKI
returns
The list:

  • int status code of the operation
  • int lock identification

getmsg(msgid:int, flags:int)->list

Returns message text associated with a given message identification code.
parameters

  • msgid:int identification of the message to be retrieved
  • flags:int message components to be returned

See OpenVMS System Services Reference Manual for SYS$GETMSG
returns
The list:

  • int status code of the operation
  • str message string
  • int optional information

getqui(func:int, context:int, item_list:object)->list

Returns information about queues and the jobs initiated from these queues.
parameters

  • func:int function code specifying the function that getqui is to perform. See vms.quidef
  • context:int context stream for this call
  • item_list:object item list supplying the information to be used by the function

See OpenVMS System Services Reference Manual for SYS$GETQUI
returns
The list:

  • int status code of the operation
  • int context

getrmi(item_list:object)->int

Returns system performance information about the local system.
parameters

  • item_list:object item list specifying which information about the local node is to be returned

See OpenVMS System Services Reference Manual for SYS$GETRMI
returns
Status code

getsyi(csid:int, node_name:str, item_list:object)->list

Returns information about the local system or about other systems in an OpenVMS Cluster system.
parameters

  • csid:int OpenVMS Cluster system identification
  • node_name:str name of the node about which information is to be returned
  • item_list:object item list specifying which information about the node or nodes to return

See OpenVMS System Services Reference Manual for SYS$GETSYI
returns
The list:

  • int status code of the operation
  • int csid

gettim()->list

Returns the current system time in a 64-bit format.
parameters
None
returns
The list:

  • int status code of the operation
  • int current system time

getuai(user_name:str, item_list:object)->int

Returns authorization information about the specified user.
parameters

  • user_name:str name of the user to get authorization information for
  • item_list:object item list specifying which information to return

See OpenVMS System Services Reference Manual for SYS$GETUAI
returns
Status code

hiber()->int

Allows a process to make itself inactive but to remain known to the system so that it can be interrupted.
parameters
None
returns
Status code

schdwk(pid:int, pname:str, time:int)->list

Schedules the awakening (restart) of a process that has placed itself in the state of hibernation with the Hibernate service.
parameters

  • pid:int process identification (PID) of the process to be awakened
  • pname:str name of the process to be awakened
  • time:int time at which the process to be awakened

See OpenVMS System Services Reference Manual for SYS$SCHDWK
returns
The list:

  • int status code of the operation
  • int pid

add_holder(id:int, holder:int, attrib:int)->int

Adds a specified holder record to a target identifier.
parameters

  • id:int target identifier granted to the specified holder
  • holder:int holder identifier that is granted access to the target identifier
  • attrib:int attributes to be placed in the holder record

See OpenVMS System Services Reference Manual for SYS$ADD_HOLDER
returns
Status code

add_ident(name:str, id:int, attrib:int)->list

Adds the specified identifier to the rights database.
parameters

  • name:str identifier name to be added to the rights database
  • id:int identifier to be created
  • attrib:int attributes placed in the identifier’s record

See OpenVMS System Services Reference Manual for SYS$ADD_IDENT
returns
The list:

  • int status code of the operation
  • int resid, identifier value assigned by the system

find_held(holder:int, context:int)->list

Returns the identifiers held by the specified holder.
parameters

  • holder:int holder whose identifiers to be found
  • context:int context value used when find_held is called repeatedly

See OpenVMS System Services Reference Manual for SYS$FIND_HELD
returns
The list:

  • int status code of the operation
  • int id, identifier value that was found
  • int attrib attributes associated with the holder returned in id
  • int context

finish_rdb(context:int)->int

Deallocates the record stream and clears the context value.
parameters

  • context:int context value to be cleared


returns
Status code

forcex(pid:int, pname:str, code:int)->int

Causes an Exit ($EXIT) service call to be issued on behalf of a specified process.
parameters

  • pid:int process identification (PID) of the process to force exit
  • pname:str process name of the process that is to force exit
  • code:int completion code value to be used as the exit parameter


returns
Status code

rem_holder(id:int, holder:int)->int

Deletes the specified holder record from the target identifier’s list of holders.
parameters

  • id:int binary value of the target identifier
  • holder:int identifier of the holder being deleted


returns
Status code

rem_ident(id:int)->int

Removes the specified identifier record and all its holder records (if any) from the rights database.
parameters

  • id:int binary value of the identifier deleted from rights database


returns
Status code

setuai(user_name:str, item_list:object)->int

Modifies the user authorization file (UAF) record for the specified user.
parameters

  • user_name:str name of the user whose UAF record is modified
  • item_list:object item list specifying which information from the specified UAF record is to be modified

See OpenVMS System Services Reference Manual for SYS$SETUAI
returns
Status code

show_intrusion(user_criteria:str, flags:int, context:int)->list

Searches for and returns information about records in the intrusion database matching the caller specifications.
parameters

  • user_criteria:str description of an intruder or suspect
  • flags:int type of records in the intrusion database about which information is to be returned. NOTE: do not use vms.ciadef.CIA_M_ITEMLIST, because user_criteria is a string
  • context:int context information to keep between related calls

See OpenVMS System Services Reference Manual for SYS$SETUAI
returns
The list:

  • int status code of the operation
  • str intruder, user specification of the matched intruder or suspect record in the intrusion database
  • int expires, quadword time format indicating the time when the record will expire
  • int type, the types of the matched record and the status of the suspect
  • int count, number of login failures or break-in attempts

rdb

Wraps the Oracle RDB functions.

Attach(dbname:string)->int

Attaches to the specified database. The string may specify the full path to the RDB database in OpenVMS format or (more commonly) a logical name pointing to the database.
parameters

  • dbname:string path or logical name


returns
Status code:

  • 0 success
  • -1 failed

CloseCursor(cursor:object)->int

Closes the specified cursor.
parameters

  • cursor:object cursor


returns
Status code:

  • 0 success
  • -1 failed

Commit()->int

Commits the current database transaction.
parameters
None
returns
Status code:

  • 0 success
  • -1 failed

Data(cursor:object, idx:int)->str

Given a cursor handle and column index (integer), returns the data value for the specified column for the last fetch operation.
parameters

  • cursor:object cursor
  • idx:int index


returns
Resulting string

DeclareCursor(name:str, statement:str)->object

Declares a cursor. Inputs are the name for the cursor and the SQL statement. On success the function returns a cursor handle that can be used with OpenCursor(), FetchCursor(), and CloseCursor().
parameters

  • name:str name for the cursor
  • statement:str SQL statement


returns
Resulting cursor

Detach()->int

Disconnects from the database.
parameters
None
returns
Status code:

  • 0 success
  • -1 failed

Error()->str

Returns a description of the last error.
parameters
None
returns
Resulting error string

Exec(sh:object)->int

Executes a previously prepared SQL statement.
parameters

  • sh:object prepared SQL statement


returns
Status code:

  • 0 success
  • -1 failed

ExecI(st:str)->int

Executes the supplied SQL statement immediately.

   Note: the last letter is a capital 'i'


parameters

  • st:str SQL statement


returns
Status code:

  • 0 success
  • -1 failed

Fetch(cursor:object)->int

Fetches a row of data for the specified cursor but does not explicitly return the fetched data. The Data() method can then be used to retrieve individual data values for each column (Ncol() can be used to determine the number of columns).
parameters

  • cursor:object cursor


returns
Status code:

  • 1 success
  • 0 success, end of stream
  • -1 failed

FetchRow(cursor:object)->list

Fetches a row of data using the specified cursor handle. The fetched data is returned as an list of strings.
parameters

  • cursor:object cursor


returns
The list of strings

Free(cursor:object)->int

Frees resources associated with the supplied cursor handle for a cursor previously declared via DeclareCursor().
parameters

  • cursor:object cursor


returns
Status code:

  • 0 success

Ncol(cursor:object)->int

Returns the number of columns (values) that would be returned by a fetch for the specified cursor.
parameters

  • cursor:object cursor


returns
Number of columns

OpenCursor(cursor:object)->int

Opens a cursor using the supplied (previously declared) cursor handle.
parameters

  • cursor:object cursor


returns
Status code:

  • 0 success
  • -1 failed

Prepare(st:string)->object

Prepares an SQL statement and returns a handle for the prepared statement that can be used in subsequent calls to Exec().
parameters

  • st:string SQL statement


returns
Resulting prepared statement

Rollback()->int

Rolls back the current database transaction.
parameters
None
returns
Status code:

  • 0 success
  • -1 failed

SetReadonly()->int

Starts a read-only transaction.
parameters
None
returns
Status code:

  • 0 success
  • -1 failed

Sqlcode()->int

Returns the SQLCODE for the last database operation.
parameters
None
returns
Resulting SQL code