Chapter 3 Intrinsic Tasks

This chapter is a quick reference for locating intrinsics that perform designated tasks. Table 3-1 “Accessing Files” through Table 3-14 “Programming in Privileged mode” describe the general task, a subtask to the general task, and the intrinsic associated with it. The general task is, in most cases, the title of a programmer's guide and the subtasks correlate to chapters within that programmer's guide. For information about the intrinsic specifically, refer to chapter 4 of this manual. For information about the use of an intrinsic, refer to the specified programmer's guide.

The tasks covered are:

Accessing Files (Table 3-1 “Accessing Files”).
Accessing Command Interpreter Features (Table 3-2 “Accessing Command Interpreter Features”).
Getting System Information (Table 3-3 “Getting System Information”).
Managing Processes (Table 3-4 “Managing Processes”).
Managing Resources and System Information (Table 3-5 “Managing Resources”).
Programming for Localization (Table 3-6 “Programming for Localization”).
Managing Message Catalogs (Table 3-7 “Managing Message Catalogs”).
Converting Data Types (Table 3-8 “Converting Data Types”).
Sorting and Merging Data (Table 3-9 “Sorting and Merging Data”).
Handling Traps (Table 3-10 “Handling Traps”).
Managing Logging Facilities (Table 3-11 “Managing Logging Facilities”).
Debugging Applications (Table 3-12 “Debugging Applications”).
Obtaining Device Information (Table 3-13 “Obtaining Device Information”)
Programming in Privileged mode (Table 3-14 “Programming in Privileged mode”).
Managing USL Files (Table 3-15 “Managing USL Files”).
Managing Data Segments (Table 3-16 “Managing Data Segments”).
Changing Stack Size (Table 3-17 “Changing Stack Size”).
Using the Compiler Library (Table 3-18 “Using the Compiler Library”).
Programming Switch (Table 3-19 “Programming Switch”).
Controlling Asynchronous Devices (Table 3-20 “Controlling Asynchronous Devices”).

Table 3-1 Accessing Files

Function	Intrinsic	Manual
Opening a file	`FOPEN` `FPARSE` `HPFOPEN`	Accessing Files Programmer's Guide (32650-90017)
Closing a File	`FCLOSE`	Accessing Files Programmer's Guide (32650-90017)
Writing data to a file	`FDEVICECONTROL` `FSETMODE` `FUPDATE` `FWRITE` `FWRITEDIR` `FWRITELABEL` `PRINT` `PRINTOP` `PRINTOPREPLY`	Accessing Files Programmer's Guide (32650-90017)
Reading data from a file	`FREAD` `FREADBACKWARD` `FREADDIR` `FREADSEEK` `FSETMODE` `READ` `READX`	Accessing Files Programmer's Guide (32650-90017)
Controlling record pointer movement	`FCONTROL` `FPOINT` `FSPACE`	Accessing Files Programmer's Guide (32650-90017)
Accessing a mapped file	`HPFOPEN`	Accessing Files Programmer's Guide (32650-90017)
Sharing a file	`FOPEN` `FLOCK` `FUNLOCK` `HPFOPEN`	Accessing Files Programmer's Guide (32650-90017)
Maintaining file security	`FOPEN` `HPFOPEN` `HPACDINFO` `HPACDPUT`	Accessing Files Programmer's Guide (32650-90017) No manual No manual
Getting file information	`FCHECK` `FERRMSG` `FFILEINFO` `FGETINFO` `FLABELINFO` `FRELATE` `FRENAME`	Accessing Files Programmer's Guide (32650-90017)
Error Checking	`HPERRDEPTH` `HPERRREAD` `HPERRMSG` `PRINTFILEINFO`	Accessing Files Programmer's Guide (32650-90017)
Accessing an RIO file	`FOPEN` `FDELETE` `FREAD` `FWRITE` `HPFOPEN`	Accessing Files Programmer's Guide (32650-90017)

Table 3-2 Accessing Command Interpreter Features

Function	Intrinsic	Manual
Using commands programmatically	`COMMAND` `HPCICOMMAND`	Command Interpreter Access and Variables Programmer's Guide (32650-90011)
Controlling variables	`HPCIDELETEVAR` `HPCIGETVAR` `HPCIPUTVAR`	Command Interpreter Access and Variables Programmer's Guide (32650-90011)
Controlling job control words (JCWs)	`FINDJCW` `GETJCW` `PUTJCW` `SETJCW`	Command Interpreter Access and Variables Programmer's Guide (32650-90011)
Identifying Parameter Input	`MYCOMMAND` `SEARCH`	Command Interpreter Access and Variables Programmer's Guide (32650-90011)

Table 3-3 Getting System Information

Function	Intrinsic	Manual
Obtaining Time and Date information	`ALMANAC` `CALENDAR` `CLOCK` `DATELINE` `PROCTIME` `TIMER`	Getting System Information Programmer's Guide (32650-90018)
Obtaining File information	`FFILEINFO` `FGETINFO` `FLABELINFO` `JOBINFO` `WHO`	Getting System Information Programmer's Guide (32650-90018)
Formatting Time and Date Information	`FMTCALENDAR` `FMTCLOCK` `FMTDATE`	Getting System Information Programmer's Guide (32650-90018)
Error Checking	`HPERRDEPTH` `HPERRREAD` `HPERRMSG` `PRINTFILEINFO`	Getting System Information Programmer's Guide (32650-90018)

Table 3-4 Managing Processes

Function	Intrinsic	Manual
Activating a Process	`ACTIVATE`	Interprocess Communication Programmer's Guide (32650-90019)
Deactivating/Suspending a Process	`ABORTSESS` `CAUSEBREAK` `IODONTWAIT` `IOWAIT` `KILL` `PAUSE` `PROCINFO` `PROCTIME` `QUIT` `QUITPROG` `STARTSESS` `SUSPEND` `TERMINATE`	Interprocess Communication Programmer's Guide (32650-90019)
Creating a Process	`CREATE` `CREATEPROCESS`	Interprocess Communication Programmer's Guide (32650-90019)
Obtaining Process Information	`FATHER` `GETINFO` `GETORIGIN` `GETPRIORITY` `GETPROCID` `GETPROCINFO` `JOBINFO`	Interprocess Communication Programmer's Guide (32650-90019)
Obtaining Mail Information	`MAIL` `RECEIVEMAIL` `SENDMAIL`	Interprocess Communication Programmer's Guide (32650-90019)

Table 3-5 Managing Resources

Function	Intrinsic	Manual
Managing Global RINs	`LOCKGLORIN` `UNLOCKGLORIN`	Resource Management Programmer's Guide (32650-90024)
Managing Local RINs	`FREELOCRIN` `GETLOCRIN` `LOCKLOCRIN` `LOCRINOWNER` `UNLOCKLOCRIN`	Resource Management Programmer's Guide (32650-90024)
	`HPFIRSTLIBRARY` `HPGETPROCLABEL` `HPMYFILE` `HPMYPROGRAM`	Resource Management Programmer's Guide (32650-90024)

Table 3-6 Programming for Localization

Function	Intrinsic	Manual
Retrieving information	`ALMANAC` `NLGETLANG` `NLINFO`	Native Language Programmer's Guide (32650-90022)
Handling characters	`NLCOLLATE` `NLFINDSTR` `NLJUDGE` `NLKEYCOMPARE` `NLMATCH` `NLMATCHINIT` `NLREPCHAR` `NLSCANMOVE` `NLSUBSTR` `NLSWITCHBUF` `NLTRANSLATE`	Native Language Programmer's Guide (32650-90022)
Formatting time and date	`NLCONVCLOCK` `NLCONVCUSTDATE` `NLFMTCALENDAR` `NLFMTCLOCK` `NLFMTCUSTDATE` `NLFMTDATE` `NLFMTLONGCAL`	Native Language Programmer's Guide (32650-90022)
Formatting numbers	`NLCONVNUM` `NLFMTNUM` `NLNUMSPEC`	Native Language Programmer's Guide (32650-90022)
Using application message catalogs	`CATCLOSE` `CATOPEN` `CATREAD` `NLAPPEND`	Native Language Programmer's Guide (32650-90022)

Table 3-7 Managing Message Catalogs

Function	Intrinsic	Manual
	`CATCLOSE` `CATOPEN` `CATREAD` `GENMESSAGE`	Message Catalogs Programmer's Guide (32650-90021)

Table 3-8 Converting Data Types

Function	Intrinsic	Manual
Converting binary numbers	`ASCII` `DASCII`	Data Types Conversion Programmer's Guide (32650-90015)
Converting numeric ASCII strings	`BINARY` `DBINARY`	Data Types Conversion Programmer's Guide (32650-90015)
Translating ASCII/EBCDIC or JISCII/EBCDIK	`CTRANSLATE`	Data Types Conversion Programmer's Guide (32650-90015)
Converting floating-point formats	`HPFPCONVERT`	Data Types Conversion Programmer's Guide (32650-90015)

Table 3-9 Sorting and Merging Data

Function	Intrinsic	Manual
Creating core merge routines (NM)	`HPMERGEEND` `HPMERGEERRORMESS` `HPMERGEINIT` `HPMERGEOUTPUT`	SORT-MERGE/XL Programmer's Guide (32650-90080)
Creating core merge routines (CM)	`MERGEEND` `MERGEERRORMESS` `MERGEINIT` `MERGEOUTPUT`	SORT-MERGE/XL Programmer's Guide (32650-90080)
Getting merge information (NM)	`HPMERGESTAT` `HPMERGETITLE`	SORT-MERGE/XL Programmer's Guide (32650-90080)
Getting merge information (CM)	`MERGESTAT` `MERGETITLE`	SORT-MERGE/XL Programmer's Guide (32650-90080)
Creating core sort routines (NM)	`HPSORTEND` `HPSORTERRORMESS` `HPSORTINIT` `HPSORTINPUT` `HPSORTOUTPUT`	SORT-MERGE/XL Programmer's Guide (32650-90080)
Creating core sort routines (CM)	`SORTEND` `SORTERRORMESS` `SORTINIT` `SORTINPUT` `SORTOUTPUT`	SORT-MERGE/XL Programmer's Guide (32650-90080)
Getting sort information (NM)	`HPSORTSTAT` `HPSORTTITLE`	SORT-MERGE/XL Programmer's Guide (32650-90080)
Getting sort information (CM)	`SORTSTAT` `SORTTITLE`	SORT-MERGE/XL Programmer's Guide (32650-90080)

Table 3-10 Handling Traps

Function	Intrinsic	Manual
	`ARITRAP` `FINTEXIT` `FINSTATE` `HPENABLTRAP` `RESETCONTROL` `XARITRAP` `XCONTRAP` `XLIBTRAP` `XSYSTRAP`	Trap Handling Programmer's Guide (32650-90026)

Table 3-11 Managing Logging Facilities

Function	Intrinsic	Manual
Marking a logical transaction	`BEGINLOG` `ENDLOG`	User Logging Programmer's Guide (32650-90027)
Closing a log file	`CLOSELOG`	User Logging Programmer's Guide (32650-90027)
Flushing the logging buffer	`FLUSHLOG`	User Logging Programmer's Guide (32650-90027)
Getting information from the log file	`LOGINFO` `LOGSTATUS`	User Logging Programmer's Guide (32650-90027)
Opening a log file	`OPENLOG`	User Logging Programmer's Guide (32650-90027)
Writing to a log file	`WRITELOG`	User Logging Programmer's Guide (32650-90027)

Table 3-12 Debugging Applications

Function	Intrinsic	Manual
Entering the debug facility	`DEBUG` `HPDEBUG`	MPE/iX System Debug Reference Manual (32650-90013)
Disarming a debug call	`HPRESETDUMP` `RESETDUMP`	MPE/iX System Debug Reference Manual (32650-90013)
Arming a debug call	`HPSETDUMP` `SETDUMP`	MPE/iX System Debug Reference Manual (32650-90013)
Producing a full stack trace	`STACKDUMP`	MPE/iX System Debug Reference Manual (32650-90013)

Table 3-13 Obtaining Device Information

Function	Intrinsic	Manual
Obtaining volume information	`HPVOLINFO`
Accessing peripheral functionality	`HPDEVCONTROL`

Table 3-14 Programming in Privileged mode

Function	Intrinsic	Manual
Starting privileged mode	`GETPRIVMODE`	Introduction to MPE XL for MPE V Programmers (30367-90005)
Ending privileged mode	`GETUSERMODE`	Introduction to MPE XL for MPE V Programmers (30367-90005)

Table 3-15 Managing USL Files

Function	Intrinsic	Manual
Changing USL files	`ADJUSTUSLF` `EXPANDUSLF`	MPE Segmenter Reference Manual (30000-90011)
Creating USL files	`CLEANUSL`	MPE Segmenter Reference Manual (30000-90011)
Initializing USL files	`INITUSLF`	MPE Segmenter Reference Manual (30000-90011)

Table 3-16 Managing Data Segments

Function	Intrinsic	Manual
	`ALTDSEG` `DMOVIN` `DMOVOUT` `FREEDSEG` `GETDSEG` `SWITCHDB`	Introduction to MPE XL for MPE V Programmers (30367-90005)

Table 3-17 Changing Stack Size

Function	Intrinsic	Manual
Changing the stack size	`DLSIZE` `ZSIZE`	Introduction to MPE XL for MPE V Programmers (30367-90005)

Table 3-18 Using the Compiler Library

Function	Intrinsic	Manual
		Compiler Library/XL Reference Manual (32650-90029)

Table 3-19 Programming Switch

Function	Intrinsic	Manual
Loading a CM procedure	`HPLOADCMPROCEDURE` `LOADPROC`	Switch Programming Guide (32650-90014)
Unloading a CM procedure	`HPUNLOADCMPROCEDURE` `UNLOADPROC`	Switch Programming Guide (32650-90014)
Loading a NM procedure	`HPLOADNMPLABEL`	Switch Programming Guide (32650-90014)
Switching from CM to NM	`HPSWTONMNAME` `HPSWTONMPLABEL`	Switch Programming Guide (32650-90014)
Switching from NM to CM	`HPSWITCHTOCM` `HPSETCCODE`	Switch Programming Guide (32650-90014)

Table 3-20 Controlling Asynchronous Devices

Function	Intrinsic	Manual
Controlling system breaks	`FCONTROL` `CAUSEBREAK`	MPE XL Asynchronous Serial Communications Programmer's Reference Manual (32022-90012)
Controlling subsystem breaks	`FCONTROL` `XCONTRAP` `RESETCONTROL`	MPE XL Asynchronous Serial Communications Programmer's Reference Manual (32022-90012)
Specifying carriage control directives	`FCONTROL` `FWRITE`	MPE XL Asynchronous Serial Communications Programmer's Reference Manual (32022-90012)
Specifying an EOR character	`FCONTROL`	MPE XL Asynchronous Serial Communications Programmer's Reference Manual (32022-90012)
Enabling/Disabling echo	`FCONTROL` `FSETMODE`	MPE XL Asynchronous Serial Communications Programmer's Reference Manual (32022-90012)
Specifying line deletion echo response	`FCONTROL`	MPE XL Asynchronous Serial Communications Programmer's Reference Manual (32022-90012)
Setting editing mode	`FCONTROL`	MPE XL Asynchronous Serial Communications Programmer's Reference Manual (32022-90012)
Setting transmission mode	`FCONTROL`	MPE XL Asynchronous Serial Communications Programmer's Reference Manual (32022-90012)
Specifying and enabling parity	`FCONTROL`	MPE XL Asynchronous Serial Communications Programmer's Reference Manual (32022-90012)
Specifying terminal type	`FCONTROL`	MPE XL Asynchronous Serial Communications Programmer's Reference Manual (32022-90012)
Setting a read timeout	`FCONTROL`	MPE XL Asynchronous Serial Communications Programmer's Reference Manual (32022-90012)
Timing a read	`FCONTROL`	MPE XL Asynchronous Serial Communications Programmer's Reference Manual (32022-90012)

Chapter 3 Intrinsic Tasks

Technical documentation

» Table of Contents

» Index