Guardian Programming Reference Summary for C Abstract This summary provides a quick reference to information required for Guardian programming in C. Product Version G09 Supported Releases This manual supports G06.15 and all subsequent releases until otherwise indicated in a new edition.
Document History Part Number Product Version Published 142747 G06.03 December 1998 422953-001 G06.06 August 1999 522630-001 G09 February 2002 Ordering Information For manual ordering information: domestic U.S. customers, call 1-800-243-6886; international customers, contact your local sales representative. Document Disclaimer Information contained in a manual is subject to change without notice. Please check with your authorized representative to make sure you have the most recent information.
Guardian Programming Reference Summary for C Tables What’s New in This Manual v Manual Information v New and Changed Information vi About This Manual vii Your Comments Invited vii Notation Conventions vii Compaq Computer Corporation —522630-001 iii
1. Process Name and ID Formats Contents 1. Process Name and ID Formats 2. File Codes 3. Device Types and Subtypes 4. Functions Summary (A-C) 5. Functions Summary (D-F) 6. Functions Summary (G-N) 7. Functions Summary (O-Q) 8. Functions Summary (R-Z) 9. CONTROL Operations 10. SET^FILE Operations 11. SETMODE Operations 12. Completion Codes 13. Traps 14. Interprocess Messages 15. Error Codes 16. ASCII Character Set 17. TNS Instruction Set TNS Alphabetical List of Instructions 323 Tables Table 3-1.
What’s New in This Manual Manual Information Guardian Programming Reference Summary for C Abstract This summary provides a quick reference to information required for Guardian programming in C. Product Version G09 Supported Releases This manual supports G06.15 and all subsequent releases until otherwise indicated in a new edition. Part Number Published 522630-001 February 2002 Document History Part Number Product Version Published 142747 G06.03 December 1998 422953-001 G06.
What’s New in This Manual New and Changed Information New and Changed Information • • • An entry has been added to Section 4, Functions Summary (A-C), in the CPU_GETINFOLIST procedure that provides a link to the PROCESSOR_GETINFOLIST_ documentation. The unsupported proc call GETSYSTEMSERIALNUMBER has been removed from Section 6, Functions Summary (G-N). Table 3-1, Device Types and Subtypes, on page 3-1 has been updated to include an entry for the 4619 disk drive.
About This Manual Your Comments Invited After using this manual, please take a moment to send us your comments. You can do this by returning a Reader Comment Card or by sending an Internet mail message. A Reader Comment Card is located at the back of printed manuals and as a separate file on the Tandem User Documentation disc. You can either fax or mail the card to us. The fax number and mailing address are provided on the card. Also provided on the Reader Comment Card is an Internet mail address.
General Syntax Notation About This Manual each side of the list, or horizontally, enclosed in a pair of brackets and separated by vertical lines. For example: LIGHTS [ ON ] [ OFF ] [ SMOOTH [ num ] ] K [ X | D ] address-1 { } Braces. A group of items enclosed in braces is a list from which you are required to choose one item. The items in the list may be arranged either vertically, with aligned braces on each side of the list, or horizontally, enclosed in a pair of braces and separated by vertical lines.
Change Bar Notation About This Manual Line Spacing. If the syntax of a command is too long to fit on a single line, each continuation line is indented three spaces and is separated from the preceding line by a blank line. This spacing distinguishes items in a continuation line from items in a vertical list of selections. For example: ALTER [ / OUT file-spec / ] CONTROLLER [ , attribute-spec ]... /* i */, /* o */.
Change Bar Notation About This Manual Guardian Programming Reference Summary for C —522630-001 x
1 Process Name and ID Formats D-Series Process File Name Formats The syntax for a process file name that identifies an unnamed process is: [node]$:cpu:pin:seq-no The syntax for a process file name that identifies a named process is: [node]process-name[:seq-no][.qual-l[.qual-2]] node specifies the name of the node on which the process is running. A node name consists of a backslash (\) followed by one through seven alphanumeric characters; the first alphanumeric character must be a letter.
Process Name and ID Formats Process Descriptors A process descriptor is a form of process file name that always includes the node and seq-no sections of the name; when identifying a named process, it never includes the optional qualifiers qual-1 or qual-2. Operating-system procedures always use the external file-name notation when returning a process descriptor. Process Handles A process handle is a 10-word structure that identifies a single named or unnamed process.
2 File Codes For additional information about file codes, refer to the Guardian Procedure Errors and Messages Manual.
File Codes 262 Transfer name file 263 Transfer DIN file 264 Transfer alias file 265 Transfer trace file 266 Transfer queue file 267 Transfer inverted attachment file 268 Transfer external objects file 275 Transfer WORDLINK and Translator format name file 276 Transfer WORDLINK and Translator character map file 277 Transfer WORDLINK and Translator batch gateway configuration file 278 Transfer WORDLINK and Translator format type file 280 Transfer WORDLINK and Translator text server text
File Codes 440 TACL saved variable segment file 450 C00 file server and ViewPoint status display configuration file 451 Event display configuration file 500 NonStop II processor microcode file 502 NonStop II microcode file for SHADOW 505 5106 Tri-Density tape drive microcode object file 510 Standard (unformatted) microcode file 520 NonStop TXP processor microcode file 521 GASM-format microcode object file 525 NonStop VLX processor microcode file 540-549 Safeguard files 550-599 NonSto
File Codes 850 DNS database file 851 SNAX5 configuration file 852 NonStop CLX shutdown file 853-854 Optical disk files 855 FUP restart file 888 Enform compiled query file 904 Exchange trace file Guardian Programming Reference Summary for C —522630-001 2 -4
3 Device Types and Subtypes Table 3-1. Device Types and Subtypes (page 1 of 14) Type Device Sub type 0 Process D-Series Description G-Series Description 0 Default subtype for general use Default subtype for general use 1-49 Reserved for definition by Tandem. The following subtypes are defined: Reserved for definition by Tandem.
Device Types and Subtypes Table 3-1. Device Types and Subtypes (page 2 of 14) Type Device 3 Disk Sub type D-Series Description G-Series Description 7 4109 (fixed-head part, 1.45 MB formatted capacity) N.A. 8 4110, 4111 (128 MB formatted capacity) N.A. 4120 (V8) (128 MB formatted capacity) N.A. 9 4114 or 4115 (264 MB formatted capacity) N.A. 10 4130 (XL8) (415 MB formatted capacity) N.A. 16 4160 (V80) (265 MB formatted capacity) with 3125 controller N.A.
Device Types and Subtypes Table 3-1. Device Types and Subtypes (page 3 of 14) Type Device 3 Disk Sub type D-Series Description G-Series Description 33 4245 (1038 MB formatted capacity) with 3681 MFC N.A. 34 4255 (2 GB formatted capacity) with 3681 MFC N.A.
Device Types and Subtypes Table 3-1. Device Types and Subtypes (page 4 of 14) Type 4 Device Magnetic tape unit Sub type D-Series Description G-Series Description 3 5101, 5103, 5104, 5110, 5114 (9-track, 45/125 ips) tape units with 3207 controllers N.A. 4 5130 (9-track, 200 ips) master tape unit or 5131 slave unit with 3208 controller N.A. 5 5120 cartridge tape unit with 3209 or 3681 controller in 3681 MFC N.A.
Device Types and Subtypes Table 3-1.
Device Types and Subtypes Table 3-1.
Device Types and Subtypes Table 3-1.
Device Types and Subtypes Table 3-1.
Device Types and Subtypes Table 3-1.
Device Types and Subtypes Table 3-1. Device Types and Subtypes (page 10 of 14) Type Device 30 Optical disk unit 31 36 Sub type D-Series Description G-Series Description 3 5420 optical disk subsystem with 3220 controller N.A. SNMP 0 NonStop SNMP Agent NonStop SNMP Agent TandemTalk 1 AppleTalk Transaction Protocol (ATP) N.A. 2 AppleTalk Data Stream Protocol (ADSP) N.A. 3 AppleTalk Session Protocol (ASP) N.A. 4 AppleTalk Printer Access Protocol (PAP) N.A.
Device Types and Subtypes Table 3-1. Device Types and Subtypes (page 11 of 14) Type Device 50 CSM 51 CP6100 Sub type D-Series Description G-Series Description 0 Communications Subsystem Manager with 3650, 6100, or 6110 controller N.A. 1 Single-board (SBSCSM) with 3605 or 3606 controller N.A. 2 N.A. SWAN Concentrator Manager(CONMGR) 3 N.A.
Device Types and Subtypes Table 3-1. Device Types and Subtypes (page 12 of 14) Type Device 55 Open Systems Interconnection (OSI) 56 Multilan Sub type D-Series Description G-Series Description 5 N.A. Tandem application, presentation, and session (TAPS) processes 11 N.A. OSI/Message Handling System (OSI/MHS) 12 N.A. OSI/Message Handling System (OSI/MHS) 20 N.A. OSI/FTAM Application Manager 21 N.A. OSI/FTAM Services 24 N.A. OSI/CMIP 25 N.A.
Device Types and Subtypes Table 3-1. Device Types and Subtypes (page 13 of 14) Type Device 59 AM6520 60 AM3270 TR3271 61 X.25 Sub type D-Series Description G-Series Description 0 Line attached to a byte-synchronous controller N.A. 10 Line attached to 3605, 6100 CSS, or 6105 or 6110 CC N.A.
Device Types and Subtypes Table 3-1. Device Types and Subtypes (page 14 of 14) Type Device 65 Storage Subsystem Manager 66 67 Sub type D-Series Description G-Series Description 0 N.A. responsible for the configuration and control of storage I/O processes NonStop Kernel Management 0 N.A. responsible for the configuration and control of system-wide attributes and generic processes SCSI Lock Management 0 N.A.
4 Functions Summary (A-C) This section lists funtions in alphabetic order and briefly describes the syntax of each. For additional information about the funtions, refer to the Guardian Procedure Calls Reference Manual. ABEND (superseded by PROCESS_STOP_) Deletes a process or a process pair. This procedure does not have C syntax, because it is superseded and should not be used for new development. This procedure is supported only for compatibility with previous software.
Functions Summary (A-C) ADDRESS_DELIMIT_ Obtains the addresses of the first and last bytes of a particular area of the caller’s logical address space. It can also obtain a set of flags that describe the area, and the logical segment ID of the area.
Functions Summary (A-C) segment-id -110 Last valid extended data segment ID. -109 Accelerator-generated code segment. -108 Accelerator read-only data segment for user code segment. -107 Accelerator-generated user library segment. -106 Accelerator read-only data segment for library code segment. -105 TNS user code segment. -104 TNS user library segment. -103 TNS user data segment. -102 Main RISC stack segment. -101 Debug stack segment. -100 Priv RISC stack segment.
Functions Summary (A-C) _status_eq () The symbolic procedure name was found; error contains 0. _status_gt () An error occurred; error contains the error value. return value: 0 Successful call; the procedure name is deposited into proc-name for procname-length bytes. 11 A procedure name was not found. 22 One of the parameters specifies an address that is out of bounds. 23 The p-reg, stack-env, and pin parameters do not indicate a legal code location.
Functions Summary (A-C) ALLOCATESEGMENT (superseded by SEGMENT_ALLOCATE_) Allocates a selectable extended data segment for use by the calling process. It can also be used to share selectable extended data segments or flat extended data segments allocated by other processes. This procedure does not have C syntax, because it is superseded and should not be used for new development. This procedure is supported only for compatibility with previous software.
Functions Summary (A-C) AWAITIO[X] Completes a previously initiated I/O operation.
Functions Summary (A-C) BINSEM_CLOSE_ Closes access to a binary semaphore. #include short BINSEM_CLOSE_ ( long semid ); /* i */ return value: 0 = No error. 29 = Required parameter missing. The semid parameter must be specified. 4022 = Invalid parameter. The semid parameter does not identify a binary semaphore that is opened by the calling process. The corresponding OSS errno value is EINVAL. 4045 = Deadlock.
Functions Summary (A-C) BINSEM_FORCELOCK_ Forces a lock on a binary semaphore #include short BINSEM_FORCELOCK_ ( long semid /* i */ ,short *processhandle );/* o */ return value: 0 = No error. 22 = Bounds error. The processhandle parameter cannot be written to by the calling process. 4022 = Invalid parameter. The semid parameter does not identify a binary semaphore that is opened by the calling process. The corresponding OSS errno value is EINVAL. 4045 = Deadlock.
Functions Summary (A-C) BINSEM_OPEN_ Opens a binary semaphore. #include short BINSEM_OPEN_ ( long *semid /* o */ ,short *processhandle /* i */ ,long proc-semid ); /* i */ return value: 0 = No error. 22 = Bounds error. The semid parameter cannot be written by the calling process, or processhandle cannot be read from the calling process. 29 = Required parameter missing. The semid, processhandle, and procsemid parameters must be specified. 4002 = No entry.
Functions Summary (A-C) return value: 0 = No error. 4001 = Cannot lock. The semid parameter is not locked by the calling process. The corresponding OSS errno value is EPERM. 4022 = Invalid parameter. The semid parameter does not identify a binary semaphore that is opened by the calling process. The corresponding OSS errno value is EINVAL. BREAKMESSAGE_SEND_ Sends a break-on-device message to a specified process.
Functions Summary (A-C) CANCELREQ Cancels an incomplete operation on a file opened for nowait I/O. #include _cc_status CANCELREQ ( short filenum /* i */ ,[ long tag ] );/* i */ _status_lt () An error occurred (call FILEINFO). _status_eq () The operation was canceled. CANCELTIMEOUT Cancels a timer initiated by SIGNALTIMEOUT.
Functions Summary (A-C) function >= 0 = Changes the poll state bit. -1 = Changes the polling type. -2 = Restores all partially disabled stations. parameter >= 0 = Set (1) or clear (0) poll or select state bit. -1 = Continuous polling (0) or noncontinuous polling (>0). -2 = Dummy value. CHECK^BREAK Tests whether the BREAK key has been pressed since the last CHECK^BREAK. CHECK^BREAK is a sequential I/O (SIO) procedure and can be used only with files that have been opened by OPEN^FILE.
Functions Summary (A-C) CHECK^FILE Checks the file characteristics. CHECK^FILE is a sequential I/O (SIO) procedure and can be used only with files that have been opened by OPEN^FILE.
Functions Summary (A-C) CHECKDEFINE Updates a backup process with a DEFINE that was changed in the primary process. This passive backup procedure is not supported in C programs. For a comparison of active backup and passive backup, refer to the Guardian Programmer’s Guide. CHECKMONITOR Is called by a backup process to monitor the state of the primary process and to return control to the appropriate point (in the backup process) in the event that the primary process fails.
Functions Summary (A-C) CHECKPOINTX Is called by a primary process to send information about the primary process’s current executing state to the backup process. This passive backup procedure is not supported in C programs. For a comparison of active backup and passive backup, refer to the Guardian Programmer’s Guide. CHECKRESIZESEGMENT Complements the RESIZESEGMENT procedure. This passive backup procedure is not supported in C programs.
Functions Summary (A-C) 3 = Bounds error. 4 = Process or process pair is lost. 5 = System message is not relevant. message -2 = Local processor down. -5 = Process deletion (stop). -6 = Process deletion (abend). -8 = Network status change. -100 = Remote processor down. -101 = Process deletion. -110 = Connection to remote system lost. CLOSE (superseded by FILE_CLOSE_) Is called by a primary process to close a designated file in its backup process.
Functions Summary (A-C) CLOSEEDIT Closes a specified file that was opened by OPENEDIT or OPENEDIT_. CLOSEEDIT is an IOEdit procedure and can be used only with files that have been opened by OPENEDIT or OPENEDIT_. This procedure does not have C syntax, because it is superseded and should not be used for new development. This procedure is supported only for compatibility with previous software. CLOSEEDIT_ Closes a specified file that was opened by OPENEDIT or OPENEDIT_.
Functions Summary (A-C) COMPUTEJULIANDAYNO Converts a Gregorian calendar date on or after January 1, 0001, to a Julian day number. #include long COMPUTEJULIANDAYNO ( short year ,short month ,short day ,[ short _near *error-mask ] ); /* /* /* /* i i i o */ */ */ */ error-mask Bit 0 = Year Bit 1 = Month Bit 2 = Day COMPUTETIMESTAMP Converts a Gregorian (common civil calendar) date and time into a 64-bit Julian timestamp.
Functions Summary (A-C) errormask Bit 0 = Year Bit 1 = Month Bit 2 = Day Bit 3 = Hour of day Bit 4 = Minute of hour Bit 5 = Second of minute Bit 6 = Millisecond of second Bit 7 = Microsecond of millisecond CONFIG_GETINFO_BYLDEV CONFIG_GETINFO_BYNAME Obtain the logical and physical attributes of a device on a G-series release. Use the CONFIG_GETINFO_BYLDEV procedure to specify the device by logical device number. Use the CONFIG_GETINFO_BYNAME procedure to specify the device by name.
Functions Summary (A-C) #include short CONFIG_GETINFO_BYNAME_ ( char *devname , long length , long *common-info , long common-info-maxlen , long *common-info-len , char *specific-info , long specific-info-maxlen , long *specific-info-len , long timeout , long *error-detail ); /* /* /* /* /* /* /* /* /* /* i i o i o o i o i o */ */ */ */ */ */ */ */ */ */ return value: 0D Information was successfully returned.
Functions Summary (A-C) #include short CONFIG_GETINFO_BYLDEV2_ ( long ldevnum , long *common-info , long common-maxlen , long *common-len , char *specific-info ] , long specific-maxlen ] , long *specific-len ] , long timeout ] , long *error-detail ] ); /* /* /* /* /* /* /* /* /* i o i o o i o i o */ */ */ */ */ */ */ */ */ #include short CONFIG_GETINFO_BYNAME2_ ( char *devname , long length , long *common-info , long common-maxlen
Functions Summary (A-C) CONTIME Converts a 48-bit timestamp to a date and time in integer form. #include void CONTIME ( short ,short ,short ,short _near *date-and-time t0 t1 t2 ); /* /* /* /* o i i i */ */ */ */ date-and-time [0] = Year (1975, 1976, ... ) [1] = Month (1-12) [2] = Day (1-31) [3] = Hour (0-23) [4] = Minute (0-59) [5] = Second (0-59) [6] = 0.01 sec (0-99) CONTROL Performs device-dependent I/O operations.
Functions Summary (A-C) CONTROLBUF Performs device-dependent I/O operations requiring a data buffer. #include _cc_status CONTROLBUF ( short filenum /* ,short operation /* ,short _near *buffer /* ,short count /* ,[ short _near *count-transferred ] /* ,[ long tag ] ); /* i i i i o i */ */ */ */ */ */ _status_lt () An error occurred (call FILEINFO). _status_eq () CONTROLBUF was successful.
Functions Summary (A-C) CONVERTASCIIEBCDIC Translates the 256 EBCDIC encodings to and from the 256 8-bit ASCII encodings. For more information, refer to the Guardian Procedure Calls Reference Manual. #include void CONVERTASCIIEBCDIC ( const char* buffer /* i */ ,const unsigned short count /* i */ ,const short translation); /* i */ CONVERTPROCESSNAME (superseded by FILENAME_RESOLVE_) Converts a process name from local to network form.
Functions Summary (A-C) CONVERTTIMESTAMP Converts a GMT timestamp to or from a local-time-based timestamp within any accessible node in the network.
Functions Summary (A-C) CPUTIMES Returns the length of time, in microseconds, since the cold load that a given processor has spent in the busy, idle, or interrupt states.
Functions Summary (A-C) CREATORACCESSID (superseded by PROCESS_GETINFO_ and PROCESS_GETINFOLIST_) Obtains the creator access ID (CAID) of the process that created the calling process. This procedure does not have C syntax, because it is superseded and should not be used for new development. This procedure is supported only for compatibility with previous software. CRTPID_TO_PROCESSHANDLE_ Converts a process ID (CRTPID) to the corresponding process handle.
Functions Summary (A-C) Guardian Programming Reference Summary for C —522630-001 4- 28
5 Functions Summary (D-F) This section lists functions in alphabetic order and briefly describes the syntax of each. For additional information about the functions, refer to the Guardian Procedure Calls Reference Manual. DAYOFWEEK Takes a 32-bit Julian day number and returns the corresponding day of the week. #include short DAYOFWEEK ( long julian-day-num ); /* i */ julian-day-num 0 = Sunday, 1 = Monday, ..., 6 = Saturday. -1 = The value of julian-day-num is negative.
Functions Summary (D-F) error 0 = No error. 11 = Specified process does not exist. 13 = Invalid name. 14 = Supplied process ID references an LDEV that does not exist. 18 = Specified system is not known. 22 = Parameter or buffer out of bounds. 29 = Missing parameter. 48 = Security violation. 190 = The value of term (or the caller’s home terminal if term was not specified) is not device type 6. 201 = Unable to communicate over this path. 240-249 = Network errors.
Functions Summary (D-F) 2059 = Working set is invalid. 2066 = Missing parameter. 2069 = The DEFMODE of the process does not permit the addition of the DEFINE. checknum 001 = Specify either RETENTION or EXPIRATION, not both. 002 = If you specify USE IN or EXTEND, you must include LABELS ANSI, VOLUMES. 003 = If you specify VOLUME, you must also specify LABELS ANSI, LABELS IBM, or LABELS IBMBACKUP. If you specify one of theseLABELS, you must also specify VOLUME.
Functions Summary (D-F) return value: 0 = Add was successful. 2049 = A syntax error occurred in name. 2051 = Define does not exist. 2052 = Unable to obtain file-system buffer space. 2054 = Bounds error in define-name. 2066 = Missing parameter. DEFINEDELETEALL Deletes all DEFINEs from the calling process’s context. #include short DEFINEDELETEALL (); DEFINEINFO Returns selected information about a DEFINE.
Functions Summary (D-F) DEFINELIST Specifies the station addresses of the stations the application process wishes to communicate with, but only when the process acts as a supervisor or tributary station in a centralized multipoint configuration.
Functions Summary (D-F) return value: 0 = Successful. 2049 = A syntax error occurred in name. 2051 = DEFINE not found. 2052 = Unable to obtain file-system buffer space. 2054 = Parameter address is bad. 2066 = Missing parameter. 2060 = No more DEFINEs. DEFINEPOOL (superseded by POOL_CHECK_, POOL_DEFINE_, POOL_GETINFO_, POOL_GETSPACE_, POOL_PUTSPACE_, and POOL_RESIZE_) Designates a portion of a user’s stack or an extended data segment for use as a pool.
Functions Summary (D-F) DEFINEREADATTR Obtains the current value of an attribute in a DEFINE in the calling process’s context or in the working set. #include short DEFINEREADATTR( [ constchar *define-name ] /* ,char *attribute-name /* ,[ short _near *cursor ] /* ,char *value-buf /* ,short value-buf-len /* ,short _near *value-len /* ,[ short read-mode ] /* ,[ short _near *info-word ] );/* i i,o i,o o i o i o */ */ */ */ */ */ */ */ return value: 0 = Successful.
Functions Summary (D-F) DEFINERESTORE Uses a saved version of a DEFINE in the user’s buffer to create an active DEFINE. If an active DEFINE of the same name already exists, it can optionally be replaced. The saved DEFINE can also be placed in the working set without its name. #include short DEFINERESTORE ( short *buffer ,[ short options ] ,[ char *define-name ] ,[ short _near *checknum ] ); /* /* /* /* i i o o */ */ */ */ return value: 0 = Successful.
Functions Summary (D-F) DEFINERESTOREWORK[2] DEFINERESTOREWORK restores the DEFINE working set from the background set. DEFINERESTOREWORK2 allows a second background DEFINE working set to be restored. #include short DEFINERESTOREWORK[2] (); return value: 0 = Success. 2052 = Unable to obtain file-system buffer space. 2053 = Unable to obtain physical memory. DEFINESAVE Copies an active DEFINE or the current working attribute set into a user buffer.
Functions Summary (D-F) 2075 = The value of option (bits 0-14) is not 0. 2076 = User’s buffer is too small. 2077 = The buffer or define-name parameter is in invalid segment. 2079 = An attempt to save the working set occurred, but define-name is DEFAULTS and working set is not class DEFAULTS. option Bits 0-14 are reserved and must be 0. Bit 15 1 Save the current working set and name it define-name. 0 Save the active DEFINE named by define-name.
Functions Summary (D-F) return value: 0 = Successful. 2049 = Syntax error in name. 2052 = Unable to obtain file-system buffer space. 2055 = Attribute not supported. 2062 = Attribute name too long. 2063 = A syntax error occurred in default names. 2064 = The required attribute cannot be reset. 2066 = Parameter missing. 2067 = Illegal value.
Functions Summary (D-F) DEFINEVALIDATEWORK Checks the working set for consistency. #include short DEFINEVALIDATEWORK( short _near *checknum ); /* o */ return value: 0 = Successful. 2057 = Working set is incomplete. 2058 = Working set is inconsistent. 2059 = Working set is invalid. DELAY Allows a process to suspend itself for a timed interval.
Functions Summary (D-F) DEVICE_GETINFOBYLDEV_ Obtains the logical and physical attributes of a device.
Functions Summary (D-F) DEVICE_GETINFOBYNAME_ Obtains the logical and physical attributes of a device.
Functions Summary (D-F) DISK_REFRESH_ (superseded on G-series releases) Causes control information to be written to the associated disk volume. #include short DISK_REFRESH_ ( char *name /* i */ ,short length ); /* i */ DISKINFO (superseded by FILE_GETINFOLISTBYNAME_) Obtains information about disk volumes. This procedure does not have C syntax, because it is superseded and should not be used for new development.
Functions Summary (D-F) flags Bits 0-12 Must be 0. Bit 13 Disallow preceding sign (+/-). Bit 14 Disallow prefixes (%, #, and so on). Bit 15 Permit a two-word number of the form integer1.integer2, where each unsigned integer must fit within a 16-bit word. DNUMOUT Converts unsigned double-word integer values to their ASCII equivalents, right-justified in an array.
Functions Summary (D-F) DST_TRANSITION_ADD_ Allows a super-group user (255,n) to add an entry to the daylight-saving-time (DST) transition table. This operation is allowed only when the DAYLIGHT_SAVING_TIME option in the system is configured to the TABLE option. This procedure supersedes the ADDDSTTRANSITION procedure.
Functions Summary (D-F) Error Literal Value Description 7 ZSYS^VAL^DST^ TABLE^EMPTY The DST table has no entries. This error is returned by the DST_GETINFO_ procedure. 8 ZSYS^VAL^DST^ BOUNDS^ERROR An attempt was made to use time values outside the supported range. The supported range is 1/ 1/ 1 0:00:00.000000 through 10000/12/31 23:59:59.999999 GMT. 9 ZSYS^VAL^DST^RAN GE^LOW The specified keygmt value was less than the lowgmt value of the first DST interval with nonzero offset.
Functions Summary (D-F) status >= 0 = Indicates that the reading of the file was successful. -1 = End of file encountered. -2 = Error occurred while reading. -3 = Text file format error. -4 = Sequence error. -5 = Checksum error. -6 = Invalid buffer address. EDITREADINIT Prepares a buffer in the application program’s data area for subsequent calls to EDITREAD.
Functions Summary (D-F) EXTENDEDIT Copies an EDIT file to a new file that it creates and that has a larger extent size than the original file. EXTENDEDIT is an IOEdit procedure and can be used only with files that have been opened by OPENEDIT or OPENEDIT_. #include long EXTENDEDIT ( short *filenum /* i,o */ ,[ long start ] /* i */ ,[ long increment ] ); /* i */ FILE_ALTERLIST_ Changes certain attributes of a disk file that are normally set when the file is created.
Functions Summary (D-F) FILE_CLOSE_CHKPT_ Is called by a primary process to close a designated file in its backup process. This passive backup procedure is not supported in C programs. For a comparison of active backup and passive backup, refer to the Guardian Programmer’s Guide. FILE_COMPLETE_ completes one previously initiated I/O operation for a Guardian file or returns ready information for one Open System Services (OSS) file.
Functions Summary (D-F) FILE_COMPLETE_SET_ Enables a set of Guardian and Open System Services (OSS) files for completion by subsequent calls to the FILE_COMPLETE_ procedure. #include short FILE_COMPLETE_SET_ ( short *complete-element-list /* i */ ,short num-complete-elements /* i */ ,[ short *error-complete-element ] ); /* o */ FILE_CREATE_ Defines a new structured or unstructured disk file. This procedure operates only on Guardian objects.
Functions Summary (D-F) options Bits 0-9 Reserved (must be 0). Bit 10 Refresh EOF. A change to the end-of-file value is to cause the file label to be written immediately to disk. Bit 11 Index compression. For key-sequenced files, the entries in the index blocks are to be compressed. Must be 0 for other file types. Bit 12 Data compression. For key-sequenced files, the keys of entries in the data blocks are to be compressed. Must be 0 for other file types. Bit 13 Audit compression.
Functions Summary (D-F) type-info [0] = Device type [1] = Device subtype [2] = Object type >0 = SQL disk file 0 = Non-SQL disk file -1 = Not a disk file = File type 0 = Unstructured disk file 1 = Relative disk file 2 = Entry-sequenced disk file 3 = Key-sequenced disk file -1 = Not a disk file = File code >=0 = Disk file -1 = Not a disk file [3] [4] flags Bits 0-14 Reserved and undefined. Bit 15 File is an OSS file.
Functions Summary (D-F) type-info [0] = Device type [1] = Device subtype [2] = Object type >0 = SQL disk file 0 = Non-SQL disk file -1 = Not a disk file 0 = Unstructured disk file 1 = Relative disk file 2 = Entry-sequenced disk file 3 = Key-sequenced disk file -1 = Not a disk file = File code >=0 = Disk file -1 = Not a disk file [4] options Bits 0-12 Reserved (specify 0).
Functions Summary (D-F) FILE_GETINFOLIST_ Obtains detailed information about a file identified by file number.
Functions Summary (D-F) Code Size (bytes) Description 23 2 Open nowait depth 24 2 Open sync depth 25 2 Open options 26 4 Open information 30 2 Device type 31 2 Device subtype 32 2 Demountable disk 33 2 Audited disk 34 2 Physical record length 35 4 Logical device number 36 2 Subdevice number 40 2 SQL type 41 2 File type 42 2 File code 43 2 Logical record length 44 2 Block length 45 2 Key offset 46 2 Key length 47 2 Lock key length 50 2 Primary ex
Functions Summary (D-F) Code Size (bytes) Description 67 2 Audit compression 68 2 Data compression 69 2 Index compression 70 2 Refresh EOF 71 2 Create options 72 2 Write through 73 2 Verify writes 74 2 Serial writes 75 2 File is open 76 2 Crash open 77 2 Rollforward needed 78 2 Broken 79 2 Corrupt 80 2 Secondary partition 81 2 Index levels 82 2 SQL program 83 2 SQL valid 84 2 SQL-catalog name length 85 * SQL-catalog name 90 2 Number of partition
Functions Summary (D-F) Code Size (bytes) Description 112 4 Volume fragments 113 4 Largest volume fragment 114 16 Disk drive types 115 8 Disk drive capacities 116 2 Sequential block buffering 117 8 Last open LCT 118 8 Expiration LCT 119 8 Creation LCT 136 4 Partition EOF 137 4 Partition maximum size 140 8 Partition modification time 141 8 Partition modification LCT 142 4 Aggregate EOF 143 4 Aggregate maximum file size 144 8 Aggregate modification time 145 8
Functions Summary (D-F) FILE_GETINFOLISTBYNAME_ Obtains detailed information about a file identified by file name.
Functions Summary (D-F) 0 = Information for one locked file and all its lock holders/waiters was returned without error. More locks might exist; continue calling FILE_GETLOCKINFO_. 12 = The disk-process lock tables were changed between calls 41 = Checksum error on control. The control parameter has been altered between calls to FILE_GETLOCKINFO_ or was not initialized before the first call. 45 = Information for one locked record or file has been returned lock-descr [0] = Lock type.
Functions Summary (D-F) FILE_GETOPENINFO_ Obtains information about the opens of one disk file or all the files on a disk device, or the opens of certain nondisk devices.
Functions Summary (D-F) FILE_GETRECEIVEINFO_ Returns information about the last message read on the $RECEIVE file. #include short FILE_GETRECEIVEINFO_ ( short *receive-info ); /* o */ receive-info [0] I/O type. Indicates the data operation last performed by the message sender. 0 = Not a data message (system message). 1 = Sender called WRITE. 2 = Sender called READ. 3 = Sender called WRITEREAD. [1] Maximum reply count.
Functions Summary (D-F) FILE_OPEN_ Establishes a communication path between an application process and a file and returns a file number to the caller.
Functions Summary (D-F) Bit 3 Any file number for backup open. When performing a backup open, specifies that the system can use any file number for the backup open. 0 specifies that the backup open is to have the same file number as the primary open. Error 12 is returned if that file number is already in use. Bits 4-9 Reserved (specify 0). Bit 10 Open an OSS file by its OSS pathname. Specifies that the file to be opened is identified by the pathname parameter. Bit 11 Reserved (specify 0).
Functions Summary (D-F) FILE_RESTOREPOSITION_ The FILE_RESTOREPOSITION_ procedure supersedes the REPOSITION procedure and is used to position a disk file to a saved position (the positioning information having been saved by a call to the FILE_SAVEPOSITION_ procedure).
Functions Summary (D-F) FILE_SETPOSITION_ The FILE_SETPOSITION_ procedure supersedes the POSITION procedure. This procedure has the same function as the POSITION procedure but the FILE_SETPOSITION_ procedure accepts an 8-byte record specifier, enabling use with format 2 files.
Functions Summary (D-F) FILEINFO (superseded by FILE_GETINFO_, FILE_GETINFOBYNAME_, FILE_GETINFOLIST_, and FILE_GETINFOLISTBYNAME_) Obtains error and characteristic information about a file. This procedure does not have C syntax, because it is superseded and should not be used for new development. This procedure is supported only for compatibility with previous software.
Functions Summary (D-F) FILENAME_DECOMPOSE_ Extracts and returns one or more parts of a file name or file-name pattern.
Functions Summary (D-F) FILENAME_EDIT_ Modifies one or more parts of a file name or file-name pattern, changing them to a specified value.
Functions Summary (D-F) 2 = Replace PIN, that is, the numeric part that gives the process identification number for an unnamed process. 3 = Replace sequence number, that is, the numeric part that gives the sequence number of a process. 4 = Replace name, that is, the alphanumeric section that begins with a question mark and ends at the first colon or period. FILENAME_FINDFINISH_ Releases the resources reserved for a search that was previously initiated by a call to FILENAME_FINDSTART_.
Functions Summary (D-F) 0 1 2 3 -1 [4] = = = = = Unstructured disk file Relative disk file Entry-sequenced disk file Key-sequenced disk file Not a disk file File code: >= 0 -1 = = Disk file Not a disk file FILENAME_FINDSTART_ Sets up a search of named entities.
Functions Summary (D-F) Bit 13 If device-subtype is supplied, a file name must not match the device subtype value to be returned. Bit 14 If device-type is supplied, a file name must not match the device type value to be returned. Bit 15 If startname is supplied, and if the first name returned would be startname, then that name is to be skipped and the following name should be returned.
Functions Summary (D-F) FILENAME_RESOLVE_ Converts a partially qualified file name to a fully qualified file name.
Functions Summary (D-F) FILENAME_SCAN_ Checks for valid file-name syntax and returns the length in bytes of that part of the input string that constitutes a file name. #include short FILENAME_SCAN_ ( const char *string /* ,short length /* ,[ short *count ] /* ,[ short *kind ] /* ,[ short *entity-level ] /* ,[ short options ] ); /* i i o o o i */ */ */ */ */ */ kind 0 = File name (that is, the name of an entity). 1 = File-name pattern.
Functions Summary (D-F) FILENAME_TO_PATHNAME_ Converts a Guardian file name or subvolume name to an OSS pathname. #include short FILENAME_TO_PATHNAME_ ( const char *filename ,short length ,char *pathname ,short maxlen ,short *pathlen ,short [ options ] ,short [ *index ] ); /* /* /* /* /* /* i i o i o i */ */ */ */ */ */ return value: 0 = No error. 563 = The pathname buffer is too small to contain the resulting name.
Functions Summary (D-F) FILENAME_TO_PROCESSHANDLE_ Converts a process file name to a process handle. #include short FILENAME_TO_PROCESSHANDLE_ const char *filename ,short length ,short *processhandle ); /* i */ /* i */ /* o */ FILENAME_UNRESOLVE_ Accepts a file name as input, deletes lefthand sections that match the default values, and returns a file name that is semantically equivalent to the input file name.
Functions Summary (D-F) FIXSTRING Edits a string based on subcommands provided in a template. #include _cc_status FIXSTRING ( char *template ,short template-len ,char *data ,short _near *data-len ,[ short maximum-data-len ] ,[ short _near *modification-status ] ); /* /* /* /* /* /* i i i,o i,o i o */ */ */ */ */ */ _status_lt () One or more of the required parameters is missing. _status_eq () The operation finished successfully.
Functions Summary (D-F) FNAME32TOFNAME (obsolete) Converts a file name from the 32-character format used by the Distributed Name Service to the Guardian file-name format. This procedure does not have C syntax, because it is superseded and should not be used for new development. This procedure is supported only for compatibility with previous software. FNAMECOLLAPSE (superseded by OLDFILENAME_TO_FILENAME_) Converts a file name from internal to external form.
Functions Summary (D-F) FORMATCONVERT[X] Converts the external format to the internal form required for presentation to the FORMATDATA[X] procedures.
Functions Summary (D-F) FORMATDATA[X] Converts data-item values between internal and external representations.
Functions Summary (D-F) 0= 1= Bit 15 = Each variable-list item is a 4-word group (FORMATDATA) or a 5-word group (FORMATDATAX). Each variable-list item is a 5-word group (FORMATDATA) or a 7-word group (FORMATDATAX). Input 0= 1= FORMATDATA[X] performs output operations. FORMATDATA[X] performs input operations.
6 Functions Summary (G-N) This section lists functions in alphabetic order and briefly describes the syntax of each. For additional information about the functions, refer to the Guardian Procedure Calls Reference Manual. GETPCPBINFO Provides a process with information from its own (the current) process control block (PCB).
Functions Summary (G-N) GETCRTPID (superseded by PROCESS_GETINFO_ and PROCESS_GETINFOLIST_) Obtains the four-word process ID associated with a process CRTPID contains the process name or creation timestamp in words[0:2] and cpu,pin in word[3]. This procedure does not have a C syntax, because it is superseded and should not be used for new development. This procedure is supported only for compatibility with previous software.
Functions Summary (G-N) GETPPDENTRY (superseded by PROCESS_GETPAIRINFO_) Obtains a description of a named process pair by the process pair’s index into the destination control table (DCT). This procedure does not have a C syntax, because it is superseded and should not be used for new development. This procedure is supported only for compatibility with previous software.
Functions Summary (G-N) #include short GIVE_BREAK ( short { _near *common-fcb } /* i */ { _near *file-fcb } );/* i */ GROUP_GETINFO_ Returns attributes of the specified group.
Functions Summary (G-N) #include short GROUP_GETNEXT_ ( [ ,[ ,[ ,[ char *group-name ] short group-maxlen ] short *group-curlen ] long *groupid ] ); /* /* /* /* i o,i i,o o */ */ */ */ GROUPIDTOGROUPNAME (superseded by USER_GETINFO_) Returns the group name associated with an existing group ID from the USERID file.
Functions Summary (G-N) returned value: 0 = No error. 11 = Record not in file. The specified group has no more members or is undefined. 22 = Parameter out of bounds. An input parameter is not within the valid range, or return information does not fit into the length of the space provided, or an output parameter overlays the stack marker that was created by calling this procedure. 29 = This procedure was called without specifying all parameters. 590 = Bad parameter value.
Functions Summary (G-N) HEADROOM_ENSURE_ Allows you to check that the current stack has enough room for the needs of your process. This procedure can help you, for example, when specifying parameters for the PROCESS_LAUNCH_ procedure. Note. This procedure can be called only from a TNS/R native process. Its pTAL syntax is declared only in the EXTDECS0 file.
Functions Summary (G-N) HEAPSORTX_ Sorts an array of equal-sized elements in place. #include short HEAPSORTX_ ( short *array /* ,long num-elements /* ,short size-of-element /* ,short (*)()compare-function );/* i,o i i i */ */ */ */ return value: 0 = Array has been successfully sorted. 29 = Required parameter is missing. 590 = Invalid parameter supplied. 632 = Insufficient stack space for temporary variable.
Functions Summary (G-N) HIST_GETPRIOR_ Establishes a previous procedure call as the process context for display by the next HIST_FORMAT_ procedure call. See the HIST_INIT_ procedure for an overview of how HIST_INIT_, HIST_FORMAT_, and HIST_GETPRIOR_ can be used together to perform stack tracing. #include short HIST_GETPRIOR_ ( NSK_histWorkspace *workspace ); /* i,o */ return value: 0 = HIST_OK The procedure executed successfully. -8 = HIST_ERROR The stack tracing mechanism failed.
Functions Summary (G-N) -5 = HIST_BAD_CONTEXT A null value was specified for the context parameter. The context parameter must contain an address. -6 = HIST_NOT_IMPLEMENTED A specified options bit is defined but not implemented. -7 = HIST_INIT_ERROR An error occurred during an attempt to initialize the stack trace. -8 = HIST_ERROR The stack tracing mechanism failed while attempting to trace back to the calling procedure. -11 = HIST_MISSING_HOOK This error is not returned in the D40 release.
Functions Summary (G-N) =2 HO_Init_JmpBuf Uses the context saved in a TNS/R native jump buffer to start tracing at the point of a call to the SETJMP_ or SIGSETJMP_ procedure that filled the jump buffer. The address of the buffer is passed to HIST_INIT_ in the context parameter. = 3 HO_Init_31Regs Is reserved for Tandem use. =4 HO_Init_Address Uses a 32-bit TNS/R native address for the context. This address is passed to the HIST_INIT_ procedure in the context parameter.
Functions Summary (G-N) #include short INCREMENTEDIT ( short filenum /* i */ ,[ long increment ] );/* i */ INITIALIZEEDIT Allocates the EDIT file segment (EFS) to be used by IOEdit and initializes the data structures that it contains. #include short INITIALIZEEDIT ( ,[ ,[ ,[ [ short *swapvol ] short maxfiles ] short errorabend ] short nowait-option ] ); /* /* /* /* i i i i */ */ */ */ nowait-option 0 = Don’t use double buffering on any file.
Functions Summary (G-N) #include long INTERPRETINTERVAL ( long ,[ short ,[ short ,[ short ,[ short ,[ short long time _near *hours ] _near *minutes ] _near *seconds ] _near *milsecs ] _near *microsecs ] ); /* /* /* /* /* /* i o o o o o */ */ */ */ */ */ INTERPRETJULIANDAYNO Converts a Julian day number to the Gregorian year, month, and day.
Functions Summary (G-N) JULIANTIMESTAMP Returns a four-word, microsecond resolution, Julian-date-based timestamp.
Functions Summary (G-N) LABELEDTAPESUPPORT Provides a way for nonprivileged programs to determine whether tape-label processing is enabled on the system. #include short LABELEDTAPESUPPORT ( [ short sysnum ] ); /* i */ return value: 1 = Tape-label processing is enabled. 0 = Tape-label processing is not enabled. <0 = File-system error expressed as a negative value.
Functions Summary (G-N) LASTRECEIVE (superseded by FILE_GETRECEIVEINFO_) Obtains the four-word process ID and the message tag associated with the last message read from the $RECEIVE file. This procedure does not have a C syntax, because it is superseded and should not be used for new development. This procedure is supported only for compatibility with previous software.
Functions Summary (G-N) #include _cc_status LOCKREC ( short filenum /* i */ ,[ long tag ] );/* i */ _status_lt () An error occurred (call FILEINFO). _status_eq () LOCKREC was successful. _status_gt () The file is not a disk file. LONGJMP_ Performs a nonlocal goto. It restores the state of the calling process with context saved in a jump buffer by the SETJMP_ procedure.
Functions Summary (G-N) result 0 = Indicates that the buffer string does not contain any Katakana characters or that charset did not specify the Tandem Kanji multibyte character set. 1 = Indicates that the Tandem Kanji buffer string contains at least one Katakana character. MBCS_CHAR_ Indicates whether a string of bytes is part of a Tandem multibyte character set (MBCS).
Functions Summary (G-N) #include short MBCS_CHARSIZE_ ( [ short charset ] ); /* i */ result 0 Indicates that either no MBCS is configured or that the specified MBCS is not supported. nonzero Indicates that the result parameter contains the following information: Bits 0-7 Contains the display size (in columns) of the multibyte character identified by the test. Bits 8-15 Contains the internal size (in bytes) of the multibyte character identified by the test.
Functions Summary (G-N) MBCS_CODESETS_SUPPORTED_ Returns a 32-bit integer value. Each bit of the returned value indicates the presence of a particular multibyte character set (MBCS).
Functions Summary (G-N) MBCS_EXTERNAL_TO_TANDEM_ Translates a text string from a specified external format to the Tandem internal text format.
Functions Summary (G-N) MBCS_FORMAT_CRT_FIELD Formats Kanji-only or mixed data types for specific terminal types.
Functions Summary (G-N) MBCS_FORMAT_ITI_BUFFER_ Formats ITI buffers for specific terminal types.
Functions Summary (G-N) MBCS_MB_TO_SB_ Converts multibyte characters to the corresponding 1-byte ASCII characters.
Functions Summary (G-N) charset 1 = Tandem Kanji 9 = Tandem Hangul 10 = Tandem Chinese Big 5 11 = Tandem Chinese PC 12 = Tandem KSC5601 MBCS_SHIFTSTRING_ Upshifts or downshifts all alphabetic characters in a multibyte character set (MBCS) string.
Functions Summary (G-N) -4 = Invalid character in Kanji-only source string -5 = Control string parameter too long -6 = Translation truncated due to lack of space in screen field 29 = Required parameter missing external-form 0 = IBM Kanji only (without subfield strings) 1 = IBM Kanji EBCDIC 2 = IBM Kanji/Katakana-EBCDIC 3 = JEF (Fujitsu) Kanji only 4 = JEF (Fujitsu) Kanji EBCDIC 5 = JEF (Fujitsu) Kanji/Katakana-EBCDIC 6 = NEC Kanji only (not implemented) 7 = NEC Kanji/JIS
Functions Summary (G-N) MBCS_TRIMFRAGMENT_ Detects and trims trailing multibyte character fragments from text strings. #include void MBCS_TRIMFRAGMENT_ ( char *bytestring /* ,short *bytecount /* ,[ short charset ] /* ,[ short *charinfo ] );/* i i,o i o */ */ */ */ MESSAGESTATUS Determines if a particular message received through READUPDATE has been canceled.
Functions Summary (G-N) value 0 = The current limit on the number of messages to this process, as set by CONTROLMESSAGESYSTEM 1 = The current limit on the number of messages from this process, as set by CONTROLMESSAGESYSTEM 4 = The number of outstanding (non-LCB) messages to this process 5 = The number of outstanding (non-LCB) messages from this process MOM (superseded by PROCESS_GETINFO_ and PROCESS_GETINFOLIST_) Provides a process with the process ID of its creator.
Functions Summary (G-N) MONITORNEW Enables or disables the receipt of the SETTIME and Power On messages. #include void MONITORNEW ( short enable ); /* i */ enable 0 = Disable the receipt of messages. 1 = Enable the receipt of messages. MOVEX Moves data between extended data segments without the need for absolute addressing; it serves both privileged and nonprivileged users.
Functions Summary (G-N) MYGMOM (superseded by PROCESS_GETINFO_ and PROCESS_GETINFOLIST_) Gives a process that is a member of a batch job the process-ID of its job ancestor (GMOM). This procedure does not have a C syntax, because it is superseded and should not be used for new development. This procedure is supported only for compatibility with previous software. MYPID (superseded by PROCESSHANDLE_GETMINE_ and PROCESSHANDLE_DECOMPOSE_ ) Gives a process its own CPU and PIN number.
Functions Summary (G-N) NEWPROCESS (superseded by PROCESS_CREATE_ and PROCESS_LAUNCH_) Creates a new Guardian process. This procedure does not have a C syntax, because it is superseded and should not be used for new development. This procedure is supported only for compatibility with previous software. NEWPROCESSNOWAIT (superseded by PROCESS_CREATE_and PROCESS_LAUNCH_) Creates a new Guardian process using the nowait option.
Functions Summary (G-N) state 0= NO^ERROR first checks the error value in the FCB. If the FCB error is 0, NO^ERROR calls FILEINFO for the file. NODE_GETCOLDLOADINFO_ Retrieves the name of the OSIMAGE file from which the specified node was cold loaded.
Functions Summary (G-N) NODENUMBER_TO_NODENAME_ Converts a node number (system number) to the corresponding node name (system name). #include short NODENUMBER_TO_NODENAME_ ( [ long nodenumber ] /* i */ ,char *nodename /* o */ ,short maxlen /* i */ ,short *length ); /* o */ NUMBEREDIT Renumbers the lines of an EDIT file that are in a specified range. NUMBEREDIT is an IOEdit procedure and can be used only with files that have been opened by OPENEDIT or OPENEDIT_.
Functions Summary (G-N) 1 = Nonexistent number 0 = Valid conversion -1 = Illegal integer or illegal syntax NUMOUT Converts unsigned integer values to their ASCII equivalents, right-justified in an array. Any preceding blanks are filled with zeroes.
7 Functions Summary (O-Q) This section lists functions in alphabetic order and briefly describes the syntax of each. For additional information about the functions, refer to the Guardian Procedure Calls Reference Manual. OBJFILE_GETINFOLIST_ Obtains information about the object file or user library file of the calling process.
Functions Summary (O-Q) Attribute Code Attribute Description Value Representation 4 Binder length long 5 Inspect on short 6 High PIN short 7 High requesters short 8 Run named short 9 PFS size long 10 Target processor short 11 Accelerator timestamp short (4 TNS words) 12 Compilation mode (accelerated or not accelerated) short 13 Run mode (will or will not run accelerated) short OLDFILENAME_TO_FILENAME_ Converts a C-series internal file name to a D-series file name.
Functions Summary (O-Q) returned value: 0 = Message successfully converted. 1 = File-system error; error-detail contains the file-system error number. 2 = Parameter error; error-detail contains the number of the first parameter found to be in error, where 1 designates the first parameter on the left. 3 = Bounds error; error-detail contains the number of the first parameter found to be in error, where 1 designates the first parameter on the left.
Functions Summary (O-Q) BLOCKED %400D CRLF^BREAK %40000D LEVEL3^SPOOL^ENABLE %200000D MUSTBENEW %20D NOWAIT %200D OLD^RECEIVE %100000D PRINT^ERR^MSG %4D PURGE^DATA %40D READ^TRIM %2000D VAR^FORMAT %1000D WRITE^FOLD %10000D WRITE^PAD %20000D WRITE^TRIM %4000D OPENEDIT (superseded by OPENEDIT_) Allocates and initializes data blocks in the EDIT file segment (EFS) so that the specified file can be accessed later by the IOEdit procedures.
Functions Summary (O-Q) return value -1 = Page-count value is inconsistent. -2 = Page-table tags are out of order. -3 = Page-table tag is outside legal range. -4 = Page-table block number is outside of file. -5 = Page-table has duplicate block numbers. 11 = File does not exist; indicates that the file does not exist and that the flags parameter indicates read-only access to the file.
Functions Summary (O-Q) 3 = Bounds error 4 = Backup opener lost 5 = Primary opener lost; backup promoted to primary 6 = Openers lost; table entry now free 7 = Message is not a relevant status-change message message:length -2 = Local processor failure -8 = Network status change -100 = Remote processor failure -110 = Connection to remote system lost OPENINFO (superseded by FILE_GETOPENINFO_) Obtains information about one open of one disk file, of all the files on a disk device, or
Functions Summary (O-Q) PATHNAME_TO_FILENAME_ Converts an OSS pathname to a Guardian file name. #include short PATHNAME_TO_FILENAME_ ( const char *path ,char *filename ,short maxlen ,short *length ,[ short *infoflags ] ); /* /* /* /* /* i o i o o */ */ */ */ */ returned value: 0 = No error. 563 = The buffer pointed to by filename is too small. 4002 = No such pathname exists. The corresponding OSS errno value is ENOENT.
Functions Summary (O-Q) POOL_CHECK_ Checks the internal pool data structures and returns error information. #include short POOL_CHECK_ ( short *pool /* i */ ,[ long *corruption-address ] /* o */ ,[ long *block ] /* o */ ,[ long *block-size ] /* o */ ,[ short *tag-size ] ); /* o */ error 0 = No error. 2 = Required parameter missing. The pool parameter must be specified. 3 = Bounds error. A parameter on the parameter list has a bounds error. 9 = Corrupt pool header.
Functions Summary (O-Q) 4 = Invalid size. The pool-size parameter is too small to allocate the minimum size pool including the pool header. 5 = Alignment error on pool. The pool parameter is not in alignment with the selected alignment. 6 = Invalid alignment. The value of alignment is not 0, 4, 8, or 16. POOL_GETINFO_ Returns information about the specified pool.
Functions Summary (O-Q) error 0 = No error. 2 = Required parameter missing. 4 = Invalid block size. The value of block-size is not within the valid range. 9 = Corrupt pool header. 10 = Unable to allocate space. POOL_PUTSPACE_ Returns a block of memory to a buffer pool. #include short POOL_PUTSPACE_ ( short *pool /* i */ ,short *block );/* i */ returned value: 0 = No error. 2 = Required parameter missing. 3 = Bounds error.
Functions Summary (O-Q) 4 = Invalid size. The new-pool-size parameter is too small to allocate the minimum size pool, including the pool header. 9 = Corrupt pool header. 11 = Corrupt allocated blocks. Data is probably written beyond the allocated block. 12 = Corrupt free list blocks. Data is probably written into a returned block. 13 = Unable to shrink pool. POSITION (superseded by FILE_SETPOSITION_) Positions by primary key within relative and entry-sequenced files.
Functions Summary (O-Q) PROCESS_ACTIVATE_ Returns a suspended process or process pair to the ready state. #include short PROCESS_ACTIVATE_ ( short *processhandle /* i */ ,[ short specifier ] );/* i */ returned value: 0 = Process activated. 11 = Process does not exist. 48 = Security violation. 201 = Unable to communicate with the processor of the process. specifier 0 = Activate the specified process.
Functions Summary (O-Q) PROCESS_CREATE_ (superseded by PROCESS_LAUNCH_) Creates a new Guardian process and, optionally, assigns a symbolic process name to it.
Functions Summary (O-Q) create-options Bit 0-8 Reserved (specify 0) Bit 9 Bit 10 Bits 11-12 Bit 13 Bit 14 Bit 15 0 If the caller is named, the process deletion message, if any, will go only to the current instance of the calling process. 1 If the caller is named, the process deletion message, if any, will go to whatever process has the calling process’s name (regardless of sequence number) at that time.
Functions Summary (O-Q) #include short PROCESS_DEBUG_ ( [ ,[ ,[ ,[ short const short short *processhandle ] /* i char *terminal-name ] /* i length ] /* i now ] ); /* i */ */ */ */ return value: 0 = Debug request accepted. If the process to be debugged is not the calling process, the request might have been queued. 11 = Process does not exist. 48 = Security violation. 201 = Unable to communicate with the processor of the process.
Functions Summary (O-Q) returned value: 0 = Information is returned for the specified process. 1 = File-system error; error-detail contains the error number. 2 = Parameter error; error-detail contains the number of the first parameter found to be in error, where 1 designates the first parameter on the left. 3 = Bounds error; error-detail contains the number of the first parameter found to be in error, where 1 designates the first parameter on the left. 4 = Specified process does not exist.
Functions Summary (O-Q) returned value: 0 = Information is returned for the specified process or processes; errordetail contains the number of processes for which information has been returned (might be more than one process if in search mode). 1 = File-system error; error-detail contains the error number. 2 = Parameter error; error-detail contains the number of the first parameter found to be in error, where 1 designates the first parameter on the left.
Functions Summary (O-Q) Attribute Code Value Representation * 1 creator access ID short * 2 process access ID short 3 maximum priority (search only) short * 4 program file short bytelength, char * 5 home terminal short bytelength, char * 6 gmom's process handle short (10 TNS words) * 7 jobid short 8 process subtype short 9 minimum priority (search only) short 12 earliest creation time (search only) long long 13 latest creation time (search only) long long 14 lowered prio
Functions Summary (O-Q) Attribute Code Value Representation 49 qualifier info available short 50 Safeguard-authenticated logon short 51 force low short 53 creation timestamp long long 54 current pages long 55 messages sent long 56 messages received long 57 receive queue length short 58 receive queue maximum length short 59 page faults long 62 named short 65 mom’s file name short bytelength, char 66 gmom’s file name short bytelength, char 67 Safeguard-authenticated
Functions Summary (O-Q) Attribute Code Value Representation 97 OSS start time (OSS process only) long long 98 OSS group leader process ID (OSS process only) long 99 OSS process status (OSS process only) long 100 process file segment (PFS) size long 101 server class name short bytelength, char 102 origin of main stack long 103 current main stack size long 104 maximum main stack size long 105 origin of the privileged stack long 106 current privileged stack size long 107 maxim
Functions Summary (O-Q) PROCESS_GETPAIRINFO_ Obtains basic information about a named process or process pair.
Functions Summary (O-Q) options Bits 0-14 Reserved (specify 0) Bit 15 Return information only for named processes. 1 Also return information for I/O processes (that is, processes controlling devices or volumes). PROCESS_LAUNCH_ Creates a new process and, optionally, assigns a number of process attributes.
Functions Summary (O-Q) Attribute Code Value Representation 40 mom's process handle short (10 TNS words) * 41 process file security short 42 priority short * 45 logged-on state short * 47 primary short * 49 qualifier info available short * 50 Safeguard-authenticated logon short * 69 stop on logoff short * 70 propagate logon short * 71 propagate stop-on-logoff short PROCESS_SETSTRINGINFO_ Alters a single string-form attribute of a specified process, and optionally returns the
Functions Summary (O-Q) PROCESS_SPAWN_ Creates a new Open System Services (OSS) process and, optionally, assigns a number of process attributes. You can use this procedure to create only OSS processes, although you can call it from either a Guardian process or an OSS process. To create a Guardian process, call the PROCESS_CREATE_ procedure. For more information about the PROCESS_SPAWN function, refer to the Open System Services System Calls Reference Manual.
Functions Summary (O-Q) options Bits 0-14 Reserved (specify 0) Bit 15 Normal termination (STOP) 1 Abnormal termination (ABEND) PROCESS_SUSPEND_ Places a process or process pair into the suspended state. #include short PROCESS_SUSPEND_ ( short *processhandle /* i */ ,[ short specifier ] );/* i */ returned value: 0 = Process has been successfully suspended. 11 = Process does not exist. 48 = A security violation has occurred.
Functions Summary (O-Q) PROCESSHANDLE_COMPARE_ Compares two process handles and reports whether they are identical, represent different processes of the same process pair, or are different. #include short PROCESSHANDLE_COMPARE_ (short *processhandle-1 /* i */ ,short *processhandle-2 );/* i */ status 0 = Process handles are unrelated. 1 = Process handles are not identical but designate a process pair. 2 = Process handles are identical.
Functions Summary (O-Q) return value: 0 = Information returned successfully. 3 = Parameter address out of bounds. PROCESSHANDLE_NULLIT_ Initializes a process handle to a null value. #include short PROCESSHANDLE_NULLIT_ ( short *processhandle ); /* o */ return value: 0 = Operation was successful. 22 = Parameter is out of bounds. 29 = Parameter is missing. PROCESSHANDLE_TO_CRTPID_ Converts a process handle to the corresponding process ID (CRTPID).
Functions Summary (O-Q) options Bits 0-14 Not currently used (specify 0). Bit 15 For named processes: if set, specifies that the sequence number not be included in filename for a named process. PROCESSHANDLE_TO_STRING_ Converts a process handle to the equivalent process string.
Functions Summary (O-Q) PROCESSNAME_CREATE_ Returns a unique process name that is suitable for passing to the PROCESS_CREATE_ procedure. #include short PROCESSNAME_CREATE_ ( char *name /* o ,short maxlen /* i ,short *namelen /* o ,[ short name-type ] /* i ,[ const char *nodename ] /* i ,[ short length ] /* i ,[ short options ] ); /* i */ */ */ */ */ */ */ returned value: 0 = Process name is returned successfully. 44 = No names of the specified type are available.
Functions Summary (O-Q) PROCESSOR_GETINFOLIST_ Obtains configuration information and statistics about a processor.
Functions Summary (O-Q) Code Attribute Value Representation 9 current locked memory long 10 maximum locked memory long 11 high locked memory long 12 page faults long 13 scans per memory manager call long 14 memory clock cycles long 15 memory pressure short 16 memory queue length short 17 local time offset long long 18 elapsed time long long 19 busy time long long 20 idle time long long 21 interrupt time long long 22 processor queue length short 23 dispatches l
Functions Summary (O-Q) Code Attribute Value Representation 48 processor name short bytelength, char 49 processor full name short bytelength, char 56 base time long long 57 memory-management attributes long 58 segments in use long 59 maximum segments used long 60 the update part of the release ID (the two digits that follow the period) short 61 for Compaq internal use only 62 availability of IEEE floating point on the current system short Note.
Functions Summary (O-Q) name:maxlen processor type 0 “NonStop 1+” (no longer supported) 1 “NonStop II” (no longer supported) 2 “TXP” (no longer supported) 3 “VLX” (no longer supported) 4 “CLX” 5 “Cyclone” 6 “NSR-L” 7 “NSR-N,” “NSR-P,” or “NSR-K” 8 “NSR-W” 9 “NSR-G” or “NSR-T” PROCESSORSTATUS Obtains the number and the status of the processor modules in a system.
Functions Summary (O-Q) 5 = Tandem NonStop Cyclone processor. 6 = Tandem NonStop NSR-L processor. 7 = Tandem NonStop NSR-N, NSR-P, or NSR-K processor. 8 = Tandem NonStop NSR-W processor. 9 = Tandem NonStop NSR-G or NSR-T processor. PROCESSSTRING_SCAN_ Scans an input string for a process string and returns the corresponding process handle or a single component of the process string converted to internal form.
Functions Summary (O-Q) This procedure does not have a C syntax, because it is superseded and should not be used for new development. This procedure is supported only for compatibility with previous software.
Functions Summary (O-Q) PROGRAMFILENAME (superseded by PROCESS_GETINFO_ and PROCESS_GETINFOLIST_) Obtains the name of the calling process’s program file. This procedure does not have a C syntax, because it is superseded and should not be used for new development. This procedure is supported only for compatibility with previous software. PURGE (superseded by FILE_PURGE_) Deletes a disk file that is not open. This procedure operates only on Guardian objects.
8 Functions Summary (R-Z) This section lists functions in alphabetic order and briefly describes the syntax of each. For additional information about the functions, refer to the Guardian Procedure Calls Reference Manual. RAISE Note. This procedure can be called only from TNS/R native processes. RAISE_ is the pTAL procedure name for the C raise() function. The C raise() function complies with the POSIX.1 standard. See the $SYSTEM.SYSTEM.HSIGNAL header file for the pTAL prototype definitions.
Functions Summary (R-Z) _status_lt () An error occurred (call FILEINFO). _status_lt () Also returned following a successful read with an insertion-ordered alternate key path if the alternate key value of the current record is equal to the alternate key value in the following record along that path. A call to FILE_GETINFO_ or FILEINFO shows that error 551 occurred; this error is advisory only and does not indicate an unsuccessful read operation.
Functions Summary (R-Z) READEDIT Reads one line from a specified EDIT file and returns it to the caller in unpacked format. READEDIT is an IOEdit procedure and can be used only with files that have been opened by OPENEDIT or OPENEDIT_.
Functions Summary (R-Z) READLOCK[X] Sequentially locks and reads records in a disk file, exactly like the combination of LOCKREC and READ[X]. This procedure operates only on Guardian objects.
Functions Summary (R-Z) _status_lt () An error occurred (call FILEINFO). _status_eq () The READUPDATE[X] is successful. _status_gt () A system message is received through $RECEIVE. READUPDATELOCK[X} Locks, then reads the record from the current position in the file in the same manner as the combination of LOCKREC and READUPDATE[X]. This procedure operates only on Guardian objects.
Functions Summary (R-Z) REFPARAM_BOUNDSCHECK_ Checks the validity of parameter addresses passed to the procedure that calls it. Bounds checking performed by the system is enough for most applications. This procedure, however, provides additional checks for those few applications that might need it. Primarily, REFPARAM_BOUNDSCHECK_ verifies that a specified memory area is valid for a specified type of access (read only or read/write).
Functions Summary (R-Z) flags Bits 0-13 Must be zero. Bit 14 =0 Specifies that absolute addressing is not allowed for TNS/R native processes. =1 Allows absolute addressing even if REFPARAM_BOUNDSCHECK_ is called from a TNS/R native process. No checking is performed and REFPARAM_BOUNDSCHECK_ returns without error. =0 Checks the area for read/write access. =1 Checks the area for read-only access.
Functions Summary (R-Z) Bits 0-7 The uppercase ASCII letter that indicates system level: Bits 8-15 E 1.1 and Expand and the TMF subsystem K Ann releases L Bnn releases M Cnn releases N Dnn releases P Fnn releases Q Gnn releases The revision number of the system in binary format RENAME (superseded by FILE_RENAME_) Changes the name of a disk file that is open. If the file is temporary, assigning a name makes the file permanent. This procedure operates only on Guardian objects.
Functions Summary (R-Z) _status_lt () An error occurred (call FILE_GETINFO_ or FILEINFO). _status_eq () The REPLY[X] is successful. _status_gt () A warning occurred (call FILE_GETINFO_ or FILEINFO). error-return File System Error Condition Code Setting 0 CCE (no error) 1-9 CCG (warning) 10-32767 CCL (error) REPOSITION (superseded by FILE_RESTOREPOSITION_) Positions a disk file to a saved position.
Functions Summary (R-Z) _status_lt () An error occurred (call FILEINFO). _status_eq () RESETSYNC is successful. _status_gt () The file is not a disk file. RESIZEPOOL (superseded by POOL_CHECK_, POOL_DEFINE_, POOL_GETINFO_, POOL_GETSPACE_, POOL_PUTSPACE_, and POOL_RESIZE_) Changes the size of a pool that was initialized by the DEFINEPOOL procedure.
Functions Summary (R-Z) _status_lt () indicates resource allocation failure. _status_eq () indicates that the segment was resized successfully; error contains 0. _status_gt () indicates that an error occurred; error contains the error value (the specified extended segment was unaffected). returned value: -2 = Unable to allocate segment space. -1 = Unable to allocate page table space.
Functions Summary (R-Z) SEGMENT_ALLOCATE_ Allocates an extended data segment for use by the calling process. #include short SEGMENT_ALLOCATE_ ( short segment-id /* ,[ long segment-size ] /* ,[ char *filename ] /* ,[ short length ] /* ,[ short *error-detail ] /* ,[ short pin ] /* ,[ short segment-type ] /* ,[ long *base-address ] /* ,[ long max-size ] /* ,[ short alloc-options ] );/* i i i i o i i o i i */ */ */ */ */ */ */ */ */ */ return value: 0 = No error.
Functions Summary (R-Z) alloc-options Bits 0-13 Reserved (specify 0) Bit 14 =0 Allocate a selectable segment. =1 Allocate a flat segment. If not running on a system that supports flat segments allocate a selectable segment. =0 Return the base-address in the base address parameter. =1 Allocate a flat segment starting at the address specified in the base-address parameter. Bit <14> must also be set to 1.
Functions Summary (R-Z) flags Bits 0-14 Reserved (specify 0) Bit 15 =1 Dirty pages in memory are not to be written to the swap file. =0 Dirty pages in memory are to be written to the swap file. SEGMENT_DEALLOCATE_CHKPT_ Is called by a primary process to deallocate an extended data segment in its backup process. This passive backup procedure is not supported in C programs. For a comparison of active backup and passive backup, refer to the Guardian Programmer’s Guide.
Functions Summary (R-Z) SEGMENT_GETINFO_ Retrieves information about a currently allocated extended segment. #include short SEGMENT_GETINFO_ ( short segment-id /* ,[ long *segment-size ] /* ,[ char *filename ] /* ,[ short maxlen ] /* ,[ short *filename-len ] /* ,[ short *error-detail ] /* ,[ long *base-address ] /* ,[ short *usage-flags ] );/* i o o i o o o o */ */ */ */ */ */ */ */ return value: 0 = No error.
Functions Summary (R-Z) SEGMENT_USE_ Selects a particular extended data segment to be currently addressable by the calling process. #include short SEGMENT_USE_ ( short new-segment-id /* i ,[ short *old-segment-id ] /* i ,[ long *base-address ] /* o ,[ short *error-detail ] );/* o */ */ */ */ return value: 0 = No error. 3 = Bounds error; error-detail contains the number of the first parameter found to be in error, where 1 designates the first parameter on the left.
Functions Summary (R-Z) SET^FILE Alters file characteristics and checks the old value of those characteristics it is changing. SET^FILE is a sequential I/O (SIO) procedure and can be used only with files that have been opened by OPEN^FILE.
Functions Summary (R-Z) SETLOOPTIMER Aborts the caller if the caller begins looping (malfunctioning), and permits the caller to calculate the amount of processor time it has used. #include _cc_status SETLOOPTIMER ( short new-time-limit /* i */ ,[ short _near *old-time-limit ] );/* o */ _status_lt () The new-time-limit parameter is omitted or is specified as a negative value.
Functions Summary (R-Z) SETMODENOWAIT Sets device-dependent functions with the nowait option on nowait files. #include _cc_status SETMODENOWAIT ( short filenum /* ,short function /* ,[ short param1 ] /* ,[ short param2 ] /* ,[ short _near *last-params ] /* ,[ long tag ] ); /* i i i i o i */ */ */ */ */ */ _status_lt () An error occurred (call FILEINFO). _status_eq () The SETMODENOWAIT is successful.
Functions Summary (R-Z) function 1 = Set or fetch a remote data terminal equipment address. 2 = Set or fetch the clear cause or diagnostic bytes. 3 = Set or fetch parameters for BREAK handling. 4 = Set or fetch the reset cause or diagnostic bytes. 5 = Fetch the restart cause or diagnostic bytes. 6 = Set or fetch the 6520 and 6530 block-mode, terminal-error counters. 7 = Set or override the closed user’s group (CUG) number to be used in the next call-request packet.
Functions Summary (R-Z) SETSYNCINFO (superseded by FILE_SETSYNCINFO_) Is used by the backup process of a process pair to pass the process pair’s latest synchronization block to the file system. #include _cc_status SETSYNCINFO ( short filenum /* i */ ,short _near *sync-block );/* i */ _status_lt () An error occurred (call FILEINFO). _status_eq () SETSYNCINFO is successful. _status_gt () The file is not a disk file.
Functions Summary (R-Z) SHIFTSTRING (superseded by STRING_UPSHIFT_) Puts all the alphabetic characters in a string in lowercase or uppercase. Nonalphabetic characters remain unchanged. This procedure does not have a C syntax, because it is superseded and should not be used for new development. This procedure is supported only for compatibility with previous software. SIGACTION_ Note. This procedure can be called only from TNS/R native processes.
Functions Summary (R-Z) SIGACTION_RESTORE_ Note. This procedure can be called only from TNS/R native processes. Restores the signal-handling state saved by a previous call to the SIGACTION_SUPPLANT_ procedure. SIGACTION_SUPPLANT_ allows a subsystem (such as a shared run-time library) to take over signal handling temporarily. SIGACTION_RESTORE_ restores the signal-handling state of the process before the subsystem exits. #include
Functions Summary (R-Z) returned value: 0D = Indicates a successful outcome. -1D = Indicates an error. The reason for the error is given in the errno variable: FE_EFAULT The address in signal-buffer is out of bounds. FE_EINVAL SIG_IGN or SIG_ERR is passed to the handler. FE_ERANGE length is less than the minimum required. Use the ERRNO_GET_ procedure to obtain the value of errno in a Guardian process.
Functions Summary (R-Z) SIGJMP_MASKSET_ Saves a signal mask in a jump buffer that has already been initialized by the SIGSETJMP_ procedure. Thus, you can avoid the overhead of saving the signal mask when you call SIGSETJMP_ and instead apply the mask at a later time before performing a nonlocal goto with the SIGLONGJMP_ procedure. This technique saves setting the signal mask in applications that have many calls to SIGSETJMP_ and few calls to SIGLONGJMP_. Note.
Functions Summary (R-Z) SIGNAL_ SIGNAL_ is the pTAL procedure name for the C signal()function. The C signal()function complies with the POSIX.1 standard. See the $SYSTEM.SYSTEM.HSIGNAL header file for the pTAL prototype definitions. For a discussion of each parameter and procedure considerations, see the signal(3) function reference page either online or in the Open System Services Library Calls Reference Manual. Note. This procedure can be called only from TNS/R native processes.
Functions Summary (R-Z) _status_lt () SIGNALTIMEOUT cannot allocate a time-list element (TLE). _status_eq () SIGNALTIMEOUT completed successfully. _status_gt () The given timeout value is illegal. SIGPENDING_ SIGPENDING_ is the pTAL procedure name for the C sigpending()function. The C sigpending()function complies with the POSIX.1 standard. See the $SYSTEM.SYSTEM.HSIGNAL header file for the pTAL prototype definitions.
Functions Summary (R-Z) returned value: 0D = <>0D = Indicates that the SIGSETJMP_ procedure was called directly. Indicates that SIGSETJMP_ is returning as a result of a call to the SIGLONGJMP_ procedure. The returned value is specified by SIGLONGJMP_. mask 0D = <>0D = Specifies that the current signal mask is not to be saved. Specifies that the current signal mask is to be saved. This mask is reinstated by a corresponding call to the SIGLONGJMP_ procedure.
Functions Summary (R-Z) STRING_UPSHIFT_ Changes all the alphabetic characters in a string to uppercase.
Functions Summary (R-Z) SYSTEMENTRYPOINTLABEL Returns either the procedure label of the named entry point or a zero if no label is found. #include short SYSTEMENTRYPOINTLABEL ( char *name /* i */ ,short len ); /* i */ TAKE^BREAK Enables BREAK monitoring for a file. TAKE^BREAK is a sequential I/O (SIO) procedure and can be used only with files that have been opened by OPEN^FILE.
Functions Summary (R-Z) [4] = minute (0-59) [5] = second (0-59) [6] = 0.01 sec (0-99) TIMESTAMP Provides the internal form of the processor interval clock where the application is running. #include void TIMESTAMP ( short _near *interval-clock ); /* o */ TOSVERSION Provides an identifying letter and number indicating which version of the Guardian operating system is running.
Functions Summary (R-Z) UNLOCKFILE Unlocks a disk file and any records in the file that are currently locked by the caller. #include _cc_status UNLOCKFILE ( short filenum /* i */ ,long tag ); /* i */ _status_lt () An error occurred (call FILEINFO). _status_eq () UNLOCKFILE was successful. _status_gt () The file is not a disk file. UNLOCKREC Unlocks a record currently locked by the caller.
Functions Summary (R-Z) USER_AUTHENTICATE_ Verifies that a user exists and optionally logs on the user. This procedure should be called in a dialog mode to allow a dialog between the security mechanism and the user.
Functions Summary (R-Z) 70 = Continue dialog. See the status parameter for detailed information on how to set the inputttext parameter in the next call to USER_AUTHENTICATE_. 160 = Invalid dialog-id parameter, invalid protocol, or dialog has exceeded two minutes. 563 = The text to be returned in the displaytext parameter is longer than the length specified by the displaytext-maxlen parameter. options Bits 0-7 Reserved (specify 0).
Functions Summary (R-Z) 14 Password change request: New password is too long. New password is rejected. 15 Password change request: New password does not conform to password history (password cannot be reused). New password is rejected. 16 Password change request: New password does not conform to password quality. New password is rejected. 17 Password change request: New password contains blank characters. New password is rejected. 18 Password change request: New password is not verified.
Functions Summary (R-Z) USER_GETINFO_ Returns the default attributes of the specified user. The user can be identified by user name; by Guardian user ID; or, if Safeguard is running, by alias.
Functions Summary (R-Z) Bits 7-9 write Bits 10-12 execute Bits 13-15 purge where the legitimate fields are encoded with numbers that represent the following information: 0 A (any local user) 1 G (any local group member) 2 O (only the local owner) 3 not used 4 N (any network user) 5 C (any network group/community user) 6 U (only the network owner) 7 - (only the local super ID) USER_GETNEXT_ Returns the next user name or alias in the order in which it is stored by the security me
Functions Summary (R-Z) USERDEFAULTS (superseded by USER_GETINFO_) Returns the default attributes of the specified user. USERDEFAULTS does not return condition codes when called from a C program. USERIDTOUSERNAME (superseded by USER_GETINFO_) Returns the user name, from $SYSTEM.SYSTEM.USERID, that is associated with a designated user ID.
Functions Summary (R-Z) USESEGMENT (superseded by SEGMENT_USE_) Makes a particular extended data segment currently addressable by the calling process. You cannot call USESEGMENT directly from a C program, because it returns a value and also sets the condition-code register. To access this procedure, you must write a “jacket” procedure in TAL that is directly callable by your C program.
Functions Summary (R-Z) [13:16] Default subvolume, blank-filled Default file security, as follows: [17] Bits 0-15 Bits 0-3 Bits 4-6 Bits 7-9 Bits 10-12 Bits 13-15 Unused Read Write Execute Purge 0 A (any local user) 1 G (any local group member) 2 O (only the local owner) 3 Not used 4 N (any network user) 5 C (any network group/community user) 6 U (only the network owner) 7 - (only the local super ID (255, 255)) WAIT^FILE Waits or checks for the completion of an outstanding I/O operatio
Functions Summary (R-Z) time-limit <> 0D Wait for completion. 0D Check for completion. 0D (and error = 40) No completion. 1D Willing to wait forever. WRITE[X] Writes data from an array in the application program to an open file.
Functions Summary (R-Z) WRITEEDIT Accepts a line in unpacked format, converts it into EDIT packed line format, and writes it to the specified file. WRITEEDIT is an IOEdit procedure and can be used only with files that have been opened by OPENEDIT or OPENEDIT_.
Functions Summary (R-Z) error 10 File already includes a line with the specified record number. 45 All of the file’s possible extents are allocated and full. You can use EXTENDEDIT to increase the file’s extent size and call WRITEEDIT again. record-number >= 0 Specifies 1000 times the EDIT line number of the line to be written. -1 Specifies that the line is written at the beginning of the file. -2 Specifies that the line is written at the end of the file.
Functions Summary (R-Z) WRITEUPDATE[X] Transfers data from an array in the application program to a file.
Functions Summary (R-Z) _status_lt () An error occurred (call FILEINFO). _status_eq () WRITEUPDATEUNLOCK[X] was successful. XBNDSTEST (superseded by REFPARAM_BOUNDSCHECK_) Checks stack limits and/or parameter addresses. #include short XBNDSTEST ( char *param /* ,short bytelen /* ,short flags /* ,long long constants );/* i i i i */ */ */ */ status 1 In bounds, but in a read-only segment or (on TNS/R systems only) in the system library.
Functions Summary (R-Z) XSTACKTEST (superseded by HEADROOM_ENSURE_) Checks stack limits, ensures that adequate stack space is available, and returns a set of constants to be used with the XBNDSTEST procedure. #include short XSTACKTEST ( short _near *firstparam ,short stackwords ,short flags ,long long *constants ); /* /* /* /* i i i o */ */ */ */ status 0 Adequate stack space available. 2 Undefined flags value. 21 The value of stackwords is less than 1.
9 CONTROL Operations For additional information about the CONTROL procedure call, refer to the Guardian Procedure Calls Reference Manual. Table 9-1.
CONTROL Operations Table 9-1.
CONTROL Operations Table 9-2. CONTROL Operations 2 - 27 Operation Description Description of 2 Write end of file on unstructured disk or magnetic tape. (If disk, write access is required.) A write end of file (EOF) to an unstructured disk file sets EOF to point to the relative byte address indicated by the next-record pointer and writes the new EOF setting in the file label on disk. If this new EOF setting is out of bounds, EOF is set to the last possible position.
CONTROL Operations Table 9-2. CONTROL Operations 2 - 27 Operation Description Description of 21 Disk, allocate or deallocate extents. (Write access is required.) 0: deallocate all extents past the end-of-file extent 1: number of extents to allocate for a nonpartitional file (for DP2 disk files only) 1:16* number of partitions number of extents to allocate for a partitioned file 22 Cancel an AM3270 I/O operation. None 24 Magnetic tape, force end-of-volume (EOV).
10 SET^FILE Operations For additional information about the SET^FILE procedure call, refer to the Guardian Procedure Calls Reference Manual. SET^FILE Operations That Set Values Description of Operation Requested new-value Parameter Entered (Optional) old-value Parameter Entered (Optional) State of File ASSIGN^ BLOCK BUFLEN or ASSIGN^ BLOCK LENGTH Specifies the block length, in bytes, for the file. newblocklen blocklen Closed ASSIGN^ FILECODE Specifies the file code for the file.
SET^FILE Operations new-value Parameter Entered (Optional) old-value Parameter Entered (Optional) State of File Specifies the logical record length (in bytes) for the file. ASSIGN^RECORDLENGTH gives the default read or write count. For default values, refer to the Guardian Programmer’s Guide. newrecordlen recordlen Closed ASSIGN^ SECEXT or ASSIGN^ SECONDARY EXTENTSIZE Specifies the secondary extent size (in units of 2048-byte blocks) for the file.
SET^FILE Operations Parameter (Required) Description of Operation Requested new-value Parameter Entered (Optional) old-value Parameter Entered (Optional) State of File SET^ BREAKHIT Sets or clears break hit for the file. This is used only if the user is handling BREAK independently of the SIO procedures, or if the user has requested BREAK system messages through SET^SYSTEMMESSAGES or SET^SYSTEMMESSAGES MANY. new-state state SET^ CHECKSUM Sets or clears the checksum word in the FCB.
SET^FILE Operations Parameter (Required) Description of Operation Requested new-value Parameter Entered (Optional) old-value Parameter Entered (Optional) State of File SET^ERROR Sets file-system error code value for the file. This is used only if nowait I/O is in effect and the user makes the call to AWAITIO for the file. This is the error parameter value returned from FILEINFO.
SET^FILE Operations Parameter (Required) Description of Operation Requested new-value Parameter Entered (Optional) old-value Parameter Entered (Optional) State of File SET^ RCVUSER OPENREPLY Sets user-will-reply for the $RECEIVE file. This is used if the SIO procedures are to maintain the opener's directory, thereby limiting opens to a single process or a process pair but keeping the option to reject opens.
SET^FILE Operations Parameter (Required) Description of Operation Requested SET^SYSTEM MESSAGES Sets system message reception for the $RECEIVE file. Setting a bit in the sys-msg-mask indicates that the corresponding message is to pass back to the user. Default action is for the SIO procedures to handle all system messages.
SET^FILE Operations Parameter (Required) Description of Operation Requested new-value Parameter Entered (Optional) old-value Parameter Entered (Optional) State of File SET^SYSTEM MESSAGES (continued) The user replies to the system messages designated by this operation by using WRITE^FILE. If no WRITE^FILE is encountered before the next READ^FILE, a reply-error-code = 0 is made automatically.
SET^FILE Operations SET^FILE Operations That Set Addresses Parameter (Required) Description of Operation Requested Parameter Entered (Optional) Parameter Entered (Optional) State of File ASSIGN^ FILENAME Specifies the physical name of the file to be opened. For example: CALL SET^FILE (in^file, ASSIGN^FILENAME,@in^ filename); @filename filename FOR 12 (2byte) words Closed ASSIGN^ LOGICAL FILENAME Specifies the logical name of the file to be opened.
SET^FILE Operations Parameter (Required) Description of Operation Requested Parameter Entered (Optional) Parameter Entered (Optional) State of File SET^ OPENERS PHANDLE Sets the allowable opener’s processhandle for $RECEIVE file. This is used to restrict the openers of this process to a specified process. A typical example is using the SIO procedures to read the startup message. This operation is valid only for D-series FCBs.
SET^FILE Operations Parameter (Required) Description of Operation Requested SET^SYSTEM MESSAGES MANY Sets system message reception for the $RECEIVE file. sys-msg-maskwords is a four-word mask. Setting a bit in sys-msgmask-words indicates that the corresponding message is to pass back to the user. Default action is for the SIO procedures to handle all system messages.
SET^FILE Operations Parameter (Required) Description of Operation Requested SET^SYSTEM MESSAGES MANY (continued: word 1) sys-msg-mask-words[1] Bits 0-3 = unused Bit 4 = BREAK message Bit 5 = unused Bit 6 = time signal message (NonStop II systems only) BIt 7 = memory lock completion message (NonStop II systems only) Bit 8 = memory lock failure message (NonStop II systems only) Bits 9-13 = unused BIt 14 = open message Bit 15 = close message SET^SYSTEM MESSAGES MANY (continued: word 2) sys-ms
SET^FILE Operations Parameter (Required) Description of Operation Requested SET^SYSTEM MESSAGES MANY (continued: word 3) sys-msg-mask-words[3] Bit 0 = nowait PROCESS_CREATE_ completion Bit 1 = subordinate name inquiry Bit 2 = nowait get info by name completion Bit 3 = nowait FILENAME_FINDNEXT_ completion Bit 4 = loss of communication with node Bit 5 = establishment of communication with node Bit 6 = remote CPU down Bit 7 = remote CPU up Bits 8-15 = unused Parameter Entered (Opti
11 SETMODE Operations For additional information about the SETMODE procedure call, refer to the Guardian Procedure Calls Reference Manual. Parameters and Effect 1 Disk: Set file security param1 Bit 0 = 1 for program files only, sets accessor's ID to program file's ID when program file is run (PROGID option). Bit 1 = 1 sets CLEARONPURGE option on. This means all data in the file is physically erased from the disk (set to zeros) when the file is purged.
SETMODE Operations Parameters and Effect 3 Disk: Set write verification param1 bit 15 = 0 verified writes off (default). = 1 verified writes on. Theparam2 parameter is used with DP2 disk files only. param2 = 0 change the open option setting of the verify writes option (default). = 1 change the file label default value of the verify writes option.
SETMODE Operations Parameters and Effect 5 Line printer: Set system automatic perforation skip mode (assumes standard VFU function in channel 2) param1 bit 15 = 0 off, 66 lines per page = 1 on, 60 lines per page (default) For the 5530 line printer: param1 = 0 disable automatic perforation skip. = 1 enable automatic perforation skip (default). Theparam2 parameter is not used with function 5.
SETMODE Operations Parameters and Effect 10 Terminal: Set parity checking by system (default is configured) param1 bit 15 = 0 no checking = 1 checking Theparam2 parameter is not used with function 10. 11 Terminal: Set break ownership param1 = 0 means BREAK disabled (default setting). = any positive value means enable BREAK.
SETMODE Operations Parameters and Effect 17 Terminal: Set maximum frame size and secondary addresses 18 Terminal: Set statistics threshold, flag fill, and window size 19 Terminal: Set transaction parameters and set extended control field size 20 Terminal: Set system echo mode (default is configured) param1 bit 15 = 0 system does not echo characters as read = 1 system echoes characters as read Theparam2 parameter is not used with function 20.
SETMODE Operations 22 Line printer (subtype 3, 4, 6, and 32) or terminal: Set baud rate param1 = 0 baud rate = 50 1 baud rate = 75 2 baud rate = 110 3 baud rate = 134.
SETMODE Operations 22, continued You can specify split baud rates with the LIU-4 controller as follows. Note that the values for param1 all have bit 0 set to 1: param1 = 128 TX baud rate = 50 129 TX baud rate = 75 130 TX baud rate = 110 131 TX baud rate = 134.
SETMODE Operations 24 Terminal: Set parity generation by system param1 = 0 parity = odd 1 parity = even 2 parity = none Theparam2 parameter is not used with function 24. 25 Line printer (subtype 3): Set form length param1 = length of form in lines Theparam2 parameter is not used with function 25. 26 Line printer (subtype 3): Set or clear vertical tabs param1 = 0 is (line#-1) of where tab is to be set. = -1 clear all tabs (except line 1). Note: A vertical tab stop always exists at line 1 (top of form).
SETMODE Operations 29 Line printer (subtype 3, 4, 6, or 32): Set automatic answer mode or control answer mode. param1 bit 15 = 0 CTRLANSWER = 1 AUTOANSWER (default) The default mode is what was specified at SYSGEN; if no mode is specified at SYSGEN, then AUTOANSWER is used. Theparam2 parameter is not used with function 29. Note: SETMODE function 29 remains in effect even after the file is closed. SETMODE 29 is the only SETMODE function not affected by a SETMODE 28.
SETMODE Operations 33 To determine the actual value for port number, refer to specifications on your own network. Seven-track tape drive: Set conversion mode param1 = 0 ASCIIBCD (even parity) (default) = 1 BINARY3TO4 (odd parity) = 2 BINARY2TO3 (odd parity) = 3 BINARY1TO1 (odd parity) 36 Allow requests to be queued on $RECEIVE based on process priority param1 bit 15 = 0 use first-in-first-out (FIFO) ordering (default). = 1 use process priority ordering. Theparam2 parameter is not used with function 36.
SETMODE Operations 37, continued last-params for printer (subtype 4) last-params [0] = primary status returned from printer: bits 9-11 = full status field 0 = partial status 1 = full status 2 = full status / VFU fault 3 = reserved for future use 4 = full status / data parity error 5 = full status / buffer overflow 6 = full status / bail open 7 = full status / auxiliary status available bit 12 = buffer full 0 = not full 1 = full bit 13 = paper out 0 = OK 1 = paper out bit 14 = device power on 0 = OK 1 = PO
SETMODE Operations 37, continued Primary status bits are: [0] bits 0-8 = 0 undefined bit 9 = 1 reserved bits 10-12 = 0 no faults = 1 printer idle = 2 paper out = 3 end of ribbon = 4 data parity error = 5 buffer overflow = 6 cover open = 7 auxiliary status available bit 13 = 0 buffer not full = 1 buffer full bit 14 = 0 OK = 1 device power on error bit 15 = 0 OK = 1 device not ready If primary status last-params[0] bits 10-12 = 7, auxiliary status word is: [1] bits 0-7 = undefined bits 8-11 = fault display
SETMODE Operations 38 Terminal: Set special line-termination mode and character param1 = 0 sets special line-termination mode. param2 is the new line-termination character. The line-termination character is not counted in the length of a read. No system-supplied carriage return or line feed is issued at the end of a read (see note on cursor movement below). = 1 sets special line-termination mode. param2 is the new line-termination interrupt character.
SETMODE Operations 50 Enable/disable 3270 COPY param1 = 0 suppress COPY = 1 allow COPY 51 Get/set 3270 status param1 status flags mask to set Theparam2 parameter is not used with function 51. Refer to the Device-Specific Access Methods–AM3270/TR3271 manual for the flags mask information. 52 Tape drive: Set short write mode param1 = 0 allow writes shorter than 24 bytes; a record shorter than 24 bytes is padded with zeros to a length of 24 bytes (default). = 1 disallow writes shorter than 24 bytes.
SETMODE Operations 57 Disk: Set serial writes option param1 = 0 system automatically selects serial or parallel writes (default). = 1 change the file label default value of the serial writes option. Theparam2 parameter is used with DP2 disk files only. param2 = 0 change the open option setting of the serial writes option (default). = 1 change the file label default value of the serial writes option.
SETMODE Operations 72 Force system buffering for nowait files param1 = 1 force use of intermediate buffer in PFS for read operations. (Nowait write operations always require the data to remain unchanged until completion of the information.) = 0 allow the system to make transfers directly from user buffers. The default value for files opened by FILE_OPEN_ is 0; for files opened by OPEN it is 1. The param2 parameter is not used, and the value should be zero, if supplied.
SETMODE Operations 91 Disk: Set cache and sequential option (function 91 is not applicable for alternatekey files). param1 = 0 system managed (default). DP2 will detect sequential access; when detected, it will set LRU access to sequential and perform key-sequenced sequential splits. = 1 direct I/O, bypass disk cache. = 2 random access, LRU-chain buffer. = 3 sequential access, reuse buffer. Directs DP2 to set cache. LRU access to sequential and perform key-sequenced sequential splits.
SETMODE Operations 95 Disk: Flush dirty cache buffers The param1 parameter is not used with function 95. The param2 parameter is not used with function 95.
SETMODE Operations 110 Set Shift In/Shift Out (SISO) code extension technique for an individual subdevice Note: SETMODE 110 is supported in AM6520 for CRT protocol when used for 6530 terminals, ITI protocol for 6530 terminals, and PRT protocol for 5520 printers. param1 = 0 disable SISO (default setting) = 1 enable SISO The param2 parameter is not used with function 110.
SETMODE Operations 117 Process files: Set TRANSID forwarding param1 = 0 normal mode (default for process subtypes other than 30 and 31): If a transaction identifier is in effect at the time of a write, read, or writeread on the process file, it is sent with the request so that the receiver will operate under the transaction.
SETMODE Operations 141 DP2 disk file: Enable/disable large transfers param1 = 1 enable large transfers = 0 disable large transfers (this is the default value when the file is opened.) The param2 parameter is not used with function 141. last-params [0] contains the previous setting of the large transfer mode flag. last-params [1] if param1 is 1, this contains the value of the file's broken flag after the cache has been flushed. if param1 is 0, this contains a 0.
SETMODE Operations 141, continued If the file is audited and structured, the file must be opened with an access mode of read-only. The exclusion mode can be shared, protected, or exclusive. If the exclusion mode is shared, updates done by other openers of the file might not be seen by this opener. If the file is audited and unstructured, only read operations can be performed on the file after this SETMODE is issued with param1 set to 1.
SETMODE Operations 141, continued The length of the transfer cannot be more than 57,344 bytes. The length must be a multiple of 2K bytes. Although up to 56K bytes are transferred to the disk process in one operation, the actual transfer to the disk might not be 56K bytes at once. The disk process must do the actual data transfer to the disk in smaller pieces if more than one file extent is crossed or the controller is not a 3107 or 3108.
SETMODE Operations 144 Sets LU character set and double-byte character code The param1 parameter must be omitted for function 144. The param2 parameter must be omitted for function 144. last-params[0].
SETMODE Operations 152 Disk: Skip cache flushing when closing nonaudited file (C30 and later releases only) param1 Bit 15 = 1 for nonaudited disk files, causes the cache not to be flushed when the file is closed unless the close is either for the last open with write access or for the last open with a nonzero sync-depth value. = 0 disables the effect of SETMODE 152 with param1 = 1. The param2 parameter is not used with function 152. If it is supplied, it must be 0.
SETMODE Operations 162 Override System Compression Default on 5190 Cartridge Tape param1 = 1 No data compression = 2 Data compression (DRC) The param2 parameter is not used with function 162. Users of unlabeled tapes who do not want to use the default compression setting can use SETMODE 162 to override the default setting. BACKUP and FUP do not support this operation. This operation is allowed only at the beginning of tape (BOT).
SETMODE Operations 163 SNAX:Enhanced CDI mode param1 = 0 enables normal mode (disables all enhanced CDI support). = 1 enables enhanced CDI mode. = 2 enables special WRITEREAD mode (allows applications to determine the setting of CDI by using the WRITEREAD procedure; using WRITEREAD causes the outbound data buffer to be sent with CDI enabled). The param2 parameter is not used with function 163.
SETMODE Operations 260 Printer: Enable PostScript printing param1 = 1 The FASTP print process sends the PCL command to switch the printer to PostScript mode. At the end of the job and before the next job prints, the printer is returned to PCL mode. = 0 The FASTP print process sends the PCL command to switch the printer back to PCL mode. The param2 parameter is not used with function 260. Function 260 applies only to 5577 printers.
12 Completion Codes For a more detailed description of the completion codes, refer to the Guardian Procedure Calls Reference Manual. Completion Code Definition 0 Normal, voluntary termination with no errors. 1 Normal, voluntary termination with WARNING diagnostics. 2 Abnormal, voluntary termination with FATAL errors or diagnostics. 3 Abnormal, voluntary, but premature termination with FATAL errors or diagnostics. 4 A process associated with a RUN statement never started.
Completion Codes Completion Code Definition -7 An OSS process terminated as a result of a corrupted stack frame or register state. -8 An OSS process terminated because of insufficient user stack space for signal recovery. -9 An OSS process terminated because of insufficient PRIV stack space for signal recovery. -10 An OSS process terminated because it was unable to obtain resources for signal delivery. -11 An OSS process terminated because it attempted to resume from a nonresumable signal.
13 Traps For a more detailed description of the traps, refer to the Guardian Procedure Errors and Messages Manual.
Traps Guardian Programming Reference Summary for C —522630-001 13- 2
14 Interprocess Messages Interprocess Command Interpreter Messages For a complete description of the command interpreter interprocess messages, refer to the Guardian Programmer’s Guide. Unless otherwise specified, file name are in internal (expanded) format. Note that the user ID of a user who is logged off is 0 and the user ID of the null user (0.0) is 0.
Interprocess Messages -2 ASSIGN typedef struct CIAssign { short messageCode; /* always -2 struct { char char char char /* blank-filled */ programNameLength; programName[ 31 ]; fileNameLength; fileName[ 31 ]; /* blank-filled */ } logicalUnit; unsigned unsigned unsigned unsigned unsigned unsigned unsigned unsigned unsigned unsigned fileNameSpecified priExtSizeSpecified secExtSizeSpecified fileCodeSpecified exclusionSpecified accessSpecified recordSizeSpecified blockSizeSpecified filler1 filler2 : : :
Interprocess Messages -3 PARAM typedef struct CIParam { short messageCode; short numParams; char params [1024]; /* always -3 */ /* number of parameters */ } CIParam; The field “parameters” in the above message format is composed of “numparams” records of the following form (offsets are given in bytes): param [0] = length n, in bytes, of parameter-name param [1] for n = parameter-name param [n+1] = length v, in bytes, of parameter-value param [n+2] for v = parameter-value -20 WAKEUP typedef struc
Interprocess Messages -50 LOGON typedef struct CILogon { short short short short short messageCode; userLogonID; TACLExecPriority; TACLInputFile [12]; TACLOutputFile [12]; /* always -50 */ } CILogon; -51 LOGOFF typedef struct CILogoff { short short short short short messageCode; userLogonID; TACLExecPriority; TACLInputFile [12]; TACLOutputFile [12]; /* always -51 */ } CILogoff; -52 RUN typedef struct CIRun { short short short short short short short short short short short short messageCode; userL
Interprocess Messages -53 ILLEGAL LOGON typedef struct CIIllegalLogon { short short short short short char messageCode; userIllegalLogonID; TACLExecPriority; TACLInputFile [12]; TACLOutputFile [12]; illegalLogonString[132]; /* always -53 */ /* n <= 132 bytes */ } CIIllegalLogon; -54 ADD USER typedef struct CIAddUser { short short short short short short short short short messageCode; userLogonID; TACLExecPriority; TACLInputFile [12]; TACLOutputFile [12]; newUserGroupName [4]; newUserName [4]; newUs
Interprocess Messages -56 ALTER PRIORITY typedef struct CIAlterPriority { short short short short short short messageCode; /* userLogonID; TACLExecPriority; TACLInputFile [12]; TACLOutputFile [12]; processID [4]; /* /* short fileName [12]; /* /* short priority; /* short phandle; /* /* } CIAlterPriority; always -56 */ ID of process to be altered file name of process to be altered the new priority process handle of process to be altered */ */ */ */ */ */ */ -57 PASSWORD typedef struct CIPassword { shor
Interprocess Messages -59 PRELOGON typedef struct CIPrelogon { short short short short short short short messageCode; userLogonID; TACLExecPriority; TACLInputFile [12]; TACLOutputFile [12]; TACLLoggedOn; attemptedUserID; /* always -59 */ } CIPrelogon; Note. Logon message sent to $CMON before VERIFYUSER or USER_AUTHENTICATE_ is performed.
Interprocess Messages Interprocess System Messages For a complete description of the interprocess messages, refer to the Guardian Procedure Errors and Messages Manual.
Interprocess Messages Word Description sysmsg[0] -5 sysmsg[1] for 3 Name of the deleted process sysmsg[4] -1 sysmsg[5] Header length (header ends at sysmsg[19]) sysmsg[6] for 4 Process processor time in microseconds (a FIXED value) sysmsg[10] Job ID; 0 if the process has no GMOM sysmsg[11] Completion code sysmsg[12] Termination information; 0 if user did not supply information sysmsg[13] for 4 SPI subsystem organization name sysmsg[17] SPI subsystem number sysmsg[18] SPI subsystem ve
Interprocess Messages -6 PROCESS DELETION (ABEND) There are two forms of the ABEND message: Word Description sysmsg[0] -6 sysmsg[1] for 4 Process ID of deleted process sysmsg[5] Header length (header ends at sysmsg[19]) sysmsg[6] for 4 Process processor time in microseconds (a FIXED value) sysmsg[10] Job ID; 0 if process has no GMOM sysmsg[11] Completion code sysmsg[12] Termination information; 0 if user did not supply information sysmsg[13] for 4 SPI subsystem organization name sysmsg[17
Interprocess Messages Word Description sysmsg[11] Completion code defaults to 6 sysmsg[12] Creator access ID sysmsg[13] for 4 Process ID of the process that caused the termination If a trap is encountered, the message is changed as follows: Word Description sysmsg[11] Completion code is -1 sysmsg[12] Termination information is 0 sysmsg[13] for 4 SPI subsystem organization name is blanks sysmsg[17] SPI subsystem number is 0 sysmsg[18] SPI subsystem version is 0 sysmsg[19] Length of text
Interprocess Messages -10 SETTIME Word Description sysmsg[0] -10 sysmsg[1] processor number sysmsg[2] for 4 Signed change in microseconds (FIXED integer) sysmsg[6] Reason code 0 = Initial setting (Greenwich mean time [GMT] and local civil time [LCT] change) 1 = Subsequent adjustment (GMT and LCT time change) 2 = Daylight-savings-time transition (LCT time change) -11 POWER ON Word Description sysmsg[0] -11 sysmsg[1] processor number -12 NEWPROCESSNOWAIT COMPLETION Word Description sysmsg[0
Interprocess Messages -20 BREAK ON DEVICE Word Description sysmsg[0] -20 sysmsg[1] Logical device number, in binary, of device where BREAK was pressed. If a process called SENDBREAKMESSAGE, this field contains -1. sysmsg[2] System number, in binary, of logical device number or SENDBREAKMESSAGE caller. sysmsg[3] Most significant word of break tag. sysmsg[4] Least significant word of break tag.
Interprocess Messages -24 MEMORY LOCK FAILURE Word Description sysmsg[0] -24 sysmsg[1] Parameter 1 supplied to LOCKMEMORY (if none, 0) sysmsg[2] for 2 Parameter 2 supplied to LOCKMEMORY (if none, 0D) -26 PROCESS TIME TIMEOUT Word Description sysmsg[0] -26 sysmsg[1] Parameter 1 supplied to SIGNALPROCESSTIMEOUT (0 if none) sysmsg[2] for 2 Parameter 2 supplied to SIGNALPROCESSTIMEOUT (0D if none) -30 PROCESS OPEN Word Description sysmsg[0] -30 sysmsg[1] Flags parameter to caller’s OPEN s
Interprocess Messages -32 PROCESS CONTROL Word Description sysmsg[0] -32 sysmsg[1] Operation for CONTROL sysmsg[2] Operation parameter for CONTROL -33 PROCESS SETMODE Word Description sysmsg[0] -33 sysmsg[1] Function for SETMODE or SETMODENOWAIT sysmsg[2] Function parameter 1 for SETMODE or SETMODENOWAIT sysmsg[3] Function parameter 2 for SETMODE or SETMODENOWAIT If the receiving process can handle requests for last parameter information (by setting bit 15 of param1 in a SETMODE 80 call),
Interprocess Messages -37 PROCESS SETPARAM Word Description sysmsg[0] -37 sysmsg[1] Function parameter for SETPARAM sysmsg[2] Flags word: Bit 14, 1 if parameter array was supplied Bit 15, 1 if parameter array was returned sysmsg[3] Length of parameter array in bytes sysmsg[4:n] Parameter array of length sysmsg[3] -38 QUEUED MESSAGE CANCELLATION Word Description sysmsg[0] -38 sysmsg[1] Message tag of canceled message -40 DEVICE TYPE INQUIRY Word Description sysmsg[0] -40 sysmsg[1:4] F
Interprocess Messages -100 REMOTE CPU DOWN Word Description sysmsg[0] -100 sysmsg[1] for 2 Node number sysmsg[3] processor number sysmsg[4] Length of node name, in bytes sysmsg[5] for 3 Reserved sysmsg[8] for n Node name (including the backslash “\”) of length sysmsg[4] -101 PROCESS DELETION Word Description sysmsg[0] -101 sysmsg[1] for 10 Process phandle of terminated process sysmsg[11] for 4 Process processor time in microseconds (a FIXED value) sysmsg[15] Process job ID; 0 if the
Interprocess Messages Word Description sysmsg[40] Reserved sysmsg[41] for n Termination text of length sysmsg[34] (80-byte limit).
Interprocess Messages Word Description sysmsg[19] Offset in bytes from the beginning of the message to the beginning of the opener process name sysmsg[20] Length of the opener process name in bytes sysmsg[21] For a backup open, the file number used by the primary. It is typically, but not always, the same as the backup. Unlike the old open message, this value is never negative. sysmsg[22] Creator access ID of the opener.
Interprocess Messages -106 DEVICE TYPE INQUIRY Word Description sysmsg[0] -106 sysmsg[1] for 3 Reserved sysmsg[4] Length of the qualifier part of the file name being inquired about in bytes (zero if none given) sysmsg[5] for n Qualifier part of the file name being inquired about, in external format, of length sysmsg[4] -107 SUBORDINATE NAME INQUIRY Word Description sysmsg[0] -107 sysmsg[1] Flags: Bit 15, Skip if same; if set and the start name given below exists, skip it and return the follo
Interprocess Messages -108 NOWAIT FILE_GETINFOBYNAME_ COMPLETION Word Description sysmsg[0] -108 sysmsg[1] for 2 Tag value from the timeout-or-tag parameter to FILE_GETINFOBYNAME_ sysmsg[3] File-system error code for the request sysmsg[4] for 5 Type information (device type, and so on) having the same layout as described for the typeinfo parameter of FILE_GETINFOBYNAME_ sysmsg[9] Physical record length sysmsg[10] Flag value from the flags parameter to FILE_GETINFOBYNAME_: Bits 0-14, Currently
Interprocess Messages -111 ESTABLISHMENT OF COMMUNICATION WITH NETWORK NODE Word Description sysmsg[0] -111 sysmsg[1] for 3 Reserved sysmsg[4] for 2 Node identifier sysmsg[6] Length of node name in bytes sysmsg[7] for n Node name (including the backslash “\”) -112 JOB PROCESS CREATION Word Description sysmsg[0] -112 sysmsg[1] Job ID sysmsg[2] for 10 Process handle of the newly created process -113 REMOTE CPU UP Word Description sysmsg[0] -113 sysmsg[1] for 2 Node identifier sysmsg
Interprocess Messages Word Description sysmsg[28] for 2 ZSYS-DDL-PROCESSRESULTS.Z-PID of process-results (OSS pid of the new process) sysmsg[30] for 2 ZSYS-DDL-PROCESSRESULTS.Z-ERRNO of processresults (OSS errno) sysmsg[32] ZSYS-DDL-PROCESSRESULTS.Z-TPCERROR of processresults (Guardian error) sysmsg[33] ZSYS-DDL-PROCESSRESULTS.
Interprocess Messages Guardian Programming Reference Summary for C —522630-001 14 -24
15 Error Codes This section contains a list of error codes that are returned by Guardian procedure calls and the file system. For a full description of the error codes, refer to the Guardian Procedure Errors and Messages Manual.
Error Codes 25 AWAITIO or CANCEL was attempted on a wait file 26 AWAITIO or CANCEL was attempted on a file with no outstanding operations 27 WAIT operation attempted when outstanding requests pending 28 Number of outstanding NOWAIT operations would exceed that specified, or attempt to open a disk file or $RECEIVE with maximum number of concurrent operations greater than 1, or attempt to add more than the configured maximum subdevices for an I/O process 29 Missing parameter 30 Unable to obtain ma
Error Codes 57 Disk free space table is full 58 Disk free space table is marked bad 59 File is bad 60 File resides on removed volume, device downed or not open, or server has failed and been replaced by a different process with the same name since it was opened 61 No more file opens permitted on this volume or device 62 Volume has been mounted, but mount order has not been given, file open not permitted 63 Volume has been mounted and mount is in progress, file open not permitted 64 Volume ha
Error Codes 91 Transaction aborted by system due to database ID inconsistency 92 Distributed transaction aborted by system due to network partition 93 Transaction spanning too many audit files aborted by system 94 Transaction aborted by operator command 95 Transaction aborted because of disk process takeover by BACKUP 96 Transaction aborted because it exceeded the AUTOABORT timeout duration 97 Transaction was aborted 98 Transaction monitor process’s network active transactions table is full
Error Codes 135 Write-protect violation with disk 136 Unit ownership error (dual-port disk) 137 Controller buffer parity error 138 Interrupt overrun 139 Controller error 140 Modem error (communication link not yet established, modem failure, momentary loss of carrier, or disconnect) or FOX link to an EXPAND line handler is down 148 Invalid read or write from/to an optical disk 150 End-of-tape marker detected 151 Runaway tape detected, or attempt to access a tape whose density is lower than
Error Codes 173 Maximum allowable NAKs received (transmission error) or invalid MCW on write or invalid request ID 174 WACK received or CLB frame aborted 175 Incorrect alternating ACK received or command reject 176 POLL sequence ended with no responder 177 Text overrun (insufficient buffer space for data transfer) 178 No address list specified 179 Application buffer is incorrect or control request pending or autopoll active 180 Unknown device status received 181 Status receipt currently en
Error Codes 218 Interrupt timeout 219 Illegal device reconnect 220 Protect violation 221 Controller handshake violation 222 Bad channel status from EIO instruction 223 Bad channel status from IIO instruction 224 Controller error 225 No unit or multiple units assigned to same unit number 230 Processpr power failed, then restored 231 Controller power failed, then restored 232 Access denied, SMON communication error 233 SERVERCLASS_SEND_ error 240 Network line-handler error, operation
Error Codes 578 The block size specified is too large 579 The record size specified is too large for the given block size, file type, and format 580 An open failed because the file was oversize and the opener did not specify use of 64-bit primary keys 581 An operation involving 32-bit primary keys was attempted on an open which specified use of 64-bit keys 582 Alternate key information could not be returned because it cannot be expressed in the superseded format of the parameter 583 The extent s
Error Codes 5012 An error occurred during access of the PENDOPS table. (device type: 3.36, 25.0, or 52.0) 5013 The name range for a physical volume is exhausted. (device type: 3.36) 5014 No physical volumes are available. (device type: 3.36) 5015 The outcome for the request is unknown. (device type: 3.36, 25.0, or 52.0) 5017 Unable to read one of the SMF catalog tables. (device type: 3.36, 25.0, or 52.0) 5018 An error occurred during message processing. (device type: 3.36, 25.0, or 52.
Error Codes 518 Buffer too small 519 Invalid block length 520 Invalid record length 521 Invalid EDIT file 522 File already open 523 EDITREAD or EDITREADINIT error occurred 524 File is closed; check, read, set, write, or wait error 525 Access violation 526 No stack space 527 Temporary buffer required 528 EDIT file ran out of space 529 Write error 530 Invalid write to $RECEIVE 531 Unable to open $RECEIVE 532 I/O started 533 An internal error occurred 534 Checksum error 535
Error Codes 2060 No more DEFINEs are allowed 2061 No more attributes are allowed for the DEFINE 2062 The attribute is invalid for the DEFINE 2063 The name of the default subvolume has a syntax error in the SET DEFINE command 2064 Resetting a required DEFINE attribute is not allowed 2066 A required parameter is missing 2067 An invalid value was supplied for an attribute 2068 The CLASS name identifies a nonexistant CLASS 2069 Attempt to add a DEFINE that does not fall under current DEFMODE s
Error Codes 8 Process name error 9 Library conflict 10 Unable to communicate with system monitor process 11 File-system error on library file 12 Program file and library file are the same 13 Invalid segment size unable to set up the page tables 14 File-system error on initial setup of the swap file 15 Illegal home terminal 16 I/O error on home terminal 17 DEFINE context propagation error 18 Object file with an illegal device subtype 19 Process device subtype specified in backup proce
Error Codes 43 Program requires symbol from shared run-time library (SRL) 47 Cannot guarantee swap space 48 Mismatch on number of SRLs 49 Undefined externals in SRL 50 Incorrect number of SRLs in program file 51 Incorrect number of SRLs in library 52 SRL must be licensed 53 Unable to obtain global virtual space 54 Symbolic reference target/source type mismatch 55 External data reference not resolved to any user/system library 119 Error number returned is too large 3xx SRL has invalid
Error Codes 19 Program file and library file are the same 20 Object file with an illegal device subtype 21 Process device subtype specified in backup process is not the same as primary 22 Backup creation specified, but caller is unamed 24 DEFINE context propagation error 25 DSC error: invalid ZZPIM file 26 Dynamic IOP error 27 Invalid PFS size 29 Unable to allocate a priv stack for the process 30 Unable to lock the priv stack for the process 31 Unable to allocate a main stack for the p
Error Codes 53 The specified version, Z^VERSION, of the ZSYS^DDL^PLAUNCH^PARMS structure is incompatible with the specified length, Z^LENGTH, of the structure 54 Internal process creation error 55 The specified space guarantee cannot be allocated 56 Internal process creation error 57 A shared run-time library (SRL) has undefined externals 58 Internal process creation error 59 Internal process creation error 60 Security violation; a SRL containing callable procedures must be licensed to be us
Error Codes PROCESS_GETINFOLIST_ Error Codes Code Description 0 No error 1 A file-system error occurred 2 Parameter error 3 Bounds error 4 Specified process does not exist 5 Unable to communicate with CPU 6 Unable to connunicate with node 7 No more matches 9 Invalid search code 10 Invalid search value 11 Invalid return attribute code 12 Invalid search option Guardian Programming Reference Summary for C —522630-001 15 -16
Error Codes PROCESS_GETPAIRINFO_ Error Codes Code Description 0 No error 2 Parameter error 3 Bounds error 4 Single named process 5 Caller’s pair: caller is current primary 6 Caller’s pair: caller is current backup 7 Process is unamed 8 Search is complete 9 Process does not exist 10 Unable to communicate with node 11 Target is a process controlling a device or volume, but bit 15 was not set 13 Limited information is returned for a process that is not started PROCESS_SPAWN_ Open Sys
Error Codes ALLOCATESEGMENT Error Codes Code Description 0 No error -1 Illegal segment ID -2 Illegal segment size -3 Bounds violation on swap file parameter -4 Illegal combination of options -5 Unable to allocate segment space -6 Unable to allocate segment page table space -7 Security violation -8 PIN does not exist -9 No segment allocated to PIN -10 Trying to share segment with self -11 Requested segment is currently being resized or is incompatible SEGMENT_ALLOCATE_ Error Codes
Error Codes Subsystem Programmatic Interface (SPI) Error Codes Code Description 0 No error -1 Invalid buffer format -2 Illegal parameter value -3 Missing parameter -4 Illegal parameter address -5 Buffer full -6 Invalid checksum -7 Internal error -8 Token not found -9 Illegal token code or map -10 Invalid subsystem ID -11 Operation not supported -12 Insufficient stack space -13 File-system error -14 Guardian procedure error -15 Invalid template file -16 More text is availa
Error Codes IOEdit Error Codes In addition to the error codes shown here, the IOEdit procedures can also return filesystem error codes. Some of the file-system error codes have special meanings when returned by IOEdit. Refer to the Guardian Procedure Errors and Messages Manual for details.
16 ASCII Character Set Character Left Right Hexadecimal Decimal Meaning NUL 000000 000000 00 0 Null SOH 000400 000001 01 1 Start of heading STX 001000 000002 02 2 Start of text ETX 001400 000003 03 3 End of text EOT 002000 000004 04 4 End of transmission ENQ 002400 000005 05 5 Enquiry ACK 003000 000006 06 6 Acknowledge BEL 003400 000007 07 7 Bell BS 004000 000010 08 8 Backspace HT 004400 000011 09 9 Horizontal tabulation LF 005000 000012 A
ASCII Character Set RS 017000 000036 1E 30 Record separator US 017400 000037 1F 31 Unit separator SP 020000 000040 20 32 Space ! 020400 000041 21 33 Exclamation point " 021000 000042 22 34 Quotation mark # 021400 000043 23 35 Number sign $ 022000 000044 24 36 Dollar sign % 022400 000045 25 37 Percent sign & 023000 000046 26 38 Ampersand ' 023400 000047 27 39 Apostrophe ( 024000 000050 28 40 Opening parenthesis ) 024400 000051 29 41 Clos
ASCII Character Set A 040400 000101 41 65 Uppercase A B 041000 000102 42 66 Uppercase B C 041400 000103 43 67 Uppercase C D 042000 000104 44 68 Uppercase D E 042400 000105 45 69 Uppercase E F 043000 000106 46 70 Uppercase F G 043400 000107 47 71 Uppercase G H 044000 000110 48 72 Uppercase H I 044400 000111 49 73 Uppercase I J 045000 000112 4A 74 Uppercase J K 045400 000113 4B 75 Uppercase K L 046000 000114 4C 76 Uppercase L M 046400
ASCII Character Set d 062000 000144 64 100 Lowercase d e 062400 000145 65 101 Lowercase e f 063000 000146 66 102 Lowercase f g 063400 000147 67 103 Lowercase g h 064000 000150 68 104 Lowercase h i 064400 000151 69 105 Lowercase i j 065000 000152 6A 106 Lowercase j k 065400 000153 6B 107 Lowercase k l 066000 000154 6C 108 Lowercase l m 066400 000155 6D 109 Lowercase m n 067000 000156 6E 110 Lowercase n o 067400 000157 6F 111 Lowercase o
17 TNS Instruction Set TNS Alphabetical List of Instructions The mnemonics and opcodes for the TNS instruction set are listed in alphabetical order in the following table. For complete information about these instructions, refer to the Himalaya S-Series Server Description Manual. TNS/R instructions are not documented in this manual. A single asterisk following an instruction description denotes a privileged instruction, and a double asterisk denotes an instruction intended for operating system use only.
TNS Alphabetical List of Instructions TNS Instruction Set Mnemonic Octal Code Description BLSS -14--- Branch if Less BNDW 000450 Bounds Test Words * BNEQ -15--- Branch if Not Equal BNOC -17--- Branch if No Carry BNOV -164-- Branch if No Overflow BOX -1-4-- Branch on X BPT 000451 Instruction Breakpoint Trap BSUB -174-- Branch to Subprocedure BTST 000007 Byte Test BUN -l04-- Branch CAQ 000262 Convert ASCII to Quad CAQV 000261 Convert ASCII to Quad with Initial Value CC
TNS Alphabetical List of Instructions TNS Instruction Set Mnemonic Octal Code Description CFIR 000310 Floating to Integer (Round) CFQ 000320 Floating to Quadrupleword CFQR 000321 Floating to Quadrupleword (Round) CID 000327 Convert Integer to Doubleword CIE 000332 Convert Integer to Extended Float CIF 000331 Convert Integer to Floating CIQ 000266 Convert Integer to Quad CLQ 000267 Convert Logical to Quad CMBX 000422 Compare Bytes Extended CMPI 001--- Compare Immediate CMRW
TNS Alphabetical List of Instructions TNS Instruction Set Mnemonic Octal Code Description DLLS 1300-- Double Logical Left Shift DLRS 1301-- Double Logical Right Shift DLTE 000054 Delete Element from List * DMPY 000222 Double Multiply DNEG 000224 Double Negate DOFS 000057 Disk Record Offset ** DPCL 000032 Dynamic Procedure Call DPF 000014 Deposit Field DSUB 000221 Double Subtract DTL 000207 Determine Time Left for Element * DTST 000031 Double Test DXCH 000005 Double Ex
TNS Alphabetical List of Instructions TNS Instruction Set Mnemonic Octal Code Description ICMP 000215 Integer Compare IDIV 000213 Integer Divide IDX1 000344 Calculate Index, 1 Dimension IDX2 000345 Calculate Index, 2 Dimension IDX3 000346 Calculate Index, 3 Dimension IDXD 000317 Calculate Index, Bounds in Data Space IDXP 000347 Calculate Index, Bounds in Code SpaceIDXP IIO 000061 Interrogate I/O * IMPY 000212 Integer Multiply INEG 000214 Integer Negate INSR 000055 Insert
TNS Alphabetical List of Instructions TNS Instruction Set Mnemonic Octal Code Description LDXI 10---- Load X Immediate LLS 0300-- Logical Left Shift LMPY 000202 Logical Multiply LNEG 000204 Logical Negate LOAD -4---- Load LOR 000011 Logical OR LQAS 000445 Load Quadrupleword via A from SG * LQX 000414 Load Quadrupleword Extended LRS 0301-- Logical Right Shift LSUB 000201 Logical Subtract LWA 000360 Load Word via A LWAS 000350 Load Word via A from System LWP -2---- L
TNS Alphabetical List of Instructions TNS Instruction Set Mnemonic Octal Code Description ORLI 0044-- OR Left Immediate ORRI 004--- OR Right Immediate ORS 000035 OR to SG Memory ORX 000047 OR to Extended Memory PCAL 027--- Procedure Call POP 124--- Pop from Stack PSEM 000076 “P” a Semaphore * PUSH 024--- Push to Stack QADD 00024 Quad Add QCMP 000245 Quad Compare QDIV 000243 Quad Divide QDWN 00025- Quad Scale Down QLD 00023- Quad Load QMPY 000242 Quad Multiply Q
TNS Alphabetical List of Instructions TNS Instruction Set Mnemonic Octal Code Description RXBL 000426 Read Extended Base and Limit * SBA 000365 Store Byte via A SBAR 00017- Subtract A from a Register SBAS 000355 Store Byte via A into System SBRA 00015- Subtract Register from A SBU 1266-- Scan Bytes Until SBW 1264-- Scan Bytes While SBX 000407 Store Byte Extended SBXX 0257--, 0267-- Store Byte Extended, Indexed SCMP 000454 Set Code Map SCPV 000463 Set Current Process Vari
TNS Alphabetical List of Instructions TNS Instruction Set Mnemonic Octal Code Description STRP 00010- Set RP SVMP 000441 Save Map Entries * SWA 000361 Store Word via A SWAS 000351 Store Word via A into System SWX 000411 Store Word Extended SWXX 0255--, 0265 Store Word Extended, Indexed SXBL 000427 Set Extended Base and Limit * TOTQ 000056 Test OUTQ ** TRCE 000217 Add Entry to Trace Table * ULKX 000431 Unlock Extended Memory * VSEM 000077 "V" a Semaphore * WIOC 000511
TNS Alphabetical List of Instructions TNS Instruction Set TNS Categorized List of Instructions The mnemonics and opcodes for the instruction set are grouped by type of instruction in the following tables. For complete information about these instructions, refer to the Himalaya S-Series Server Description Manual. A single asterisk following an instruction description denotes a privileged instruction, and a double asterisk denotes an instruction intended for operating system use only.
TNS Alphabetical List of Instructions TNS Instruction Set 32-Bit Signed Arithmetic CDI 000307 Convert Double to Integer CID 000327 Convert Integer to Double DADD 000220 Double Add DSUB 000221 Double Subtract DMPY 000222 Double Multiply DDIV 000223 Double Divide DNEG 000224 Double Negate DCMP 000225 Double Compare DTST 000031 Double Test MOND 000001 (Load) Minus One Double ZERD 000002 (Load) Zero Double ONED 000003 (Load) One Double 16-Bit Signed Arithmetic (Register Sta
TNS Alphabetical List of Instructions TNS Instruction Set Decimal Arithmetic Scaling and Rounding QUP 00025- Quadruple Scale Up QDWN 00025- Quadruple Scale Down QRND 000263 Quadruple Round Decimal Arithmetic Conversions CQI 000264 Convert Quad to Integer CQL 000246 Convert Quad to Logical CQD 000247 Convert Quad to Double CQA 000260 Convert Quad to ASCII CIQ 000266 Convert Integer to Quad CLQ 000267 Convert Logical to Quad CDQ 000265 Convert Double to Quad CAQ 000262 Conver
TNS Alphabetical List of Instructions TNS Instruction Set Floating-Point Conversions CEF 000276 Convert Extended to Floating CEFR 000277 Convert Extended to Floating, Rounded CFI 000311 Convert Floating to Integer CFIR 000310 Convert Floating to Integer, Rounded CFD 000312 Convert Floating to Double CFDR 000313 Convert Floating to Double, Rounded CED 000314 Convert Extended to Double CEDR 000315 Convert Extended to Double, Rounded CEI 000337 Convert Extended to Integer CEIR 000
TNS Alphabetical List of Instructions TNS Instruction Set Register Stack Manipulation EXCH 000004 Exchange A with B DXCH 000005 Double Exchange DDUP 000006 Double Duplicate STAR 00011- Store A in a Register NSAR 00012- Nondestructive Store A in a Register LDRA 00013- Load A from a Register LDI 100--- Load Immediate LDXI 10---- Load Index Immediate LDLI 005--- Load Left Immediate LAND 000010 Logical AND LOR 000011 Logical OR XOR 000012 Exclusive OR NOT 000013 NOT ORRI
TNS Alphabetical List of Instructions TNS Instruction Set BYTE Test BTST 000007 Byte Test Memory Stack to/from Register Stack LWP -2---- Load Word from Program LBP -2-4-- Load Byte from Program PUSH 024--- Push Registers to Memory POP 124--- Pop Memory to Registers LWXX 0254--, 0264-- Load Word Extended, Indexed SWXX 0255--, 0265-- Store Word Extended, Indexed LBXX 0256--, 0266-- Load Byte Extended, Indexed SBXX 0257--, 0267-- Store Byte Extended, Indexed LDX -3---- Load Index
TNS Alphabetical List of Instructions TNS Instruction Set Load and Store via Address on Register Stack ANS 000034 AND to SG Memory ORS 000035 OR to SG Memory ANG 000044 AND to Current Data ORG 000045 OR to Current Data ANX 000046 AND to Extended Memory ORX 000047 OR to Extended Memory LWUC 000342 Load Word from User Code Segment LWAS 000350 Load Word via A from System LWA 000360 Load Word via A SWAS 000351 Store Word via A into System SWA 000361 Store Word via A LDAS 0003
TNS Alphabetical List of Instructions TNS Instruction Set Branching BIC -10--- Branch if Carry BUN -104-- Branch Unconditionally BOX -1-4-- Branch on Index BGTR -11--- Branch if CC Greater BEQL -12--- Branch if CC Equal BGEQ -13--- Branch if CC Greater or Equal BLSS -14--- Branch if CC Less BAZ -144-- Branch if A Zero BNEQ -15--- Branch if CC Not Equal BANZ -154-- Branch if A Not Zero BLEQ -16--- Branch if CC Less or Equal BNOV -164-- Branch if no Overflow BNOC -17---
TNS Alphabetical List of Instructions TNS Instruction Set Program Register Control SETL 000020 Set L Register SETS 000021 Set S Register SETE 000022 Set ENV Register SETP 000023 Set P Register RDE 000024 Read ENV Register RDP 000025 Read P Register STRP 00010- Set Register Pointer ADDS 002--- Add to S Register CCL 000015 Set CC Less CCE 000016 Set CC Equal CCG 000017 Set CC Greater PCAL 027--- Procedure Call XCAL 127--- External Procedure Call SCMP 000454 Set Code
TNS Alphabetical List of Instructions TNS Instruction Set Input/Output RSW 000026 Read Switch Register SSW 000027 Set Switch Register EIO 000060 Execute I/O * IIO 000061 Interrogate I/O * HIIO 000062 High-Priority Interrogate I/O * RCHN 000447 Reset I/O Channel * LIOC 000457 Load IOC * SIOC 000460 Store IOC * XIOC 000462 Exchange IOC entries * RIOC 000510 Read EIOC table entry * WIOC 000511 Write EIOC table entry * EIOC 000512 Exchange EIOC table entries * NOP 000000
TNS Alphabetical List of Instructions TNS Instruction Set Resource Management MXON 000040 Mutual Exclusion On * MXFF 000041 Mutual Exclusion Off * SNDQ 000052 Signal a Send Is Queued * SFRZ 000053 System Freeze * DOFS 000057 Disk Record Offset ** DLEN 000070 Disk Record Length ** HALT 000074 Processor Halt * PSEM 000076 "P" a Semaphore * VSEM 000077 "V" a Semaphore * VWCS 000401 Verify LCS * WWCS 000400 Write LCS * RWCS 000402 Read LCS * FRST 000405 Firmware Reset *
TNS Alphabetical List of Instructions TNS Instruction Set Memory Management MAPS 000042 Map In a Segment * SMAP 000067 Set Map * CRAX 000423 Convert Relative to Absolute Extended * RSPT 000424 Read Segment Page Table Entry * WSPT 000425 Write Segment Page Table Entry * RXBL 000426 Read Extended Base and Limit * SXBL 000427 Set Extended Base and Limit * LCKX 000430 Lock Down Extended Memory * ULKX 000431 Unlock Extended Memory * CMRW 000432 Correctable Memory Error Read/Write *
TNS Instruction Set TNS Alphabetical List of Instructions Guardian Programming Reference Summary for C —522630-001 17 -22
