MPE/iX Intrinsics Reference Manual > Chapter 3 Intrinsic Tasks

Chapter 3 Intrinsic Tasks

	MPE documents
	Complete PDF
	Table of Contents
	Index

	Edition 7 E0701
	Edition 7 E0300 ♥
	Edition 6 E0195

This chapter is a quick reference for locating intrinsics that perform designated tasks. Table 3-1 "Accessing Files" through Table 3-18 "Controlling Asynchronous Devices" 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 the later chapters 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-1 "Accessing Files").
Managing Processes (Table 3-3 "Managing Processes").
Managing Resources and System Information (Table 3-4 "Managing Resources").
Programming for Localization (Table 3-5 "Programming for Localization").
Managing Message Catalogs (Table 3-6 "Managing Message Catalogs").
Converting Data Types (Table 3-8 "Sorting and Merging Data").
Sorting and Merging Data (Table 3-8 "Sorting and Merging Data").
Handling Traps (Table 3-9 "Handling Traps").
Managing Logging Facilities (Table 3-10 "Managing Logging Facilities").
Debugging Applications (Table 3-11 "Debugging Applications").
Obtaining Device Information (Table 3-12 "Obtaining Device Information")
Programming in Privileged mode (Table 3-13 "Programming in Privileged mode").
Managing USL Files (Table 3-14 "Managing USL Files").
Managing Data Segments (Table 3-15 "Managing Data Segments").
Changing Stack Size (Table 3-16 "Changing Stack Size").
Programming Switch (Table 3-17 "Programming Switch").
Controlling Asynchronous Devices (Table 3-18 "Controlling Asynchronous Devices").

Table 3-1 Accessing Files

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

Table 3-2 Accessing Command Interpreter Features

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

Table 3-3 Managing Processes

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

Table 3-4 Managing Resources

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

Table 3-5 Programming for Localization

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

Table 3-6 Managing Message Catalogs

Function	Intrinsic	Manual
	`CATCLOSE CATOPEN CATREAD GENMESSAGE`	Message Catalogs Programmer's Guide
Converting binary numbers	`ASCII DASCII`	Data Types Conversion Programmer's Guide
Converting numeric ASCII strings	`BINARY DBINARY`	Data Types Conversion Programmer's Guide
Translating ASCII/EBCDIC or JISCII/EBCDIK	`CTRANSLATE`	Data Types Conversion Programmer's Guide
Converting floating-point formats	`HPFPCONVERT`	Data Types Conversion Programmer's Guide

Table 3-7 Converting Data Types

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

Table 3-8 Sorting and Merging Data

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

Table 3-9 Handling Traps

Function	Intrinsic	Manual
	`ARITRAP FINTEXIT FINSTATE HPENABLTRAP RESETCONTROL XARITRAP XCONTRAP XLIBTRAP XSYSTRAP`	Trap Handling Programmer's Guide

Table 3-10 Managing Logging Facilities

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

Table 3-11 Debugging Applications

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

Table 3-12 Obtaining Device Information

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

Table 3-13 Programming in Privileged mode

Function	Intrinsic	Manual
Starting privileged mode	`GETPRIVMODE`	Introduction to MPE XL for MPE V Programmers
Ending privileged mode	`GETUSERMODE`	Introduction to MPE XL for MPE V Programmers

Table 3-14 Managing USL Files

Function	Intrinsic	Manual
Changing USL files	`ADJUSTUSLF EXPANDUSLF`	MPE Segmenter Reference Manual
Creating USL files	`CLEANUSL`	MPE Segmenter Reference Manual
Initializing USL files	`INITUSLF`	MPE Segmenter Reference Manual

Table 3-15 Managing Data Segments

Function	Intrinsic	Manual
	`ALTDSEG DMOVIN DMOVOUT FREEDSEG GETDSEG SWITCHDB`	Introduction to MPE XL for MPE V Programmers

Table 3-16 Changing Stack Size

Function	Intrinsic	Manual
Changing the stack size	`DLSIZE ZSIZE`	Introduction to MPE XL for MPE V Programmers

Table 3-17 Programming Switch

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

Table 3-18 Controlling Asynchronous Devices

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

Additional Capabilities Required

Chapter 4 Command Definitions (ABORTSESS - FCLOSE)

Chapter 3 Intrinsic Tasks

MPE documents