HPlogo 900 Series HP 3000 Computer Systems: MPE/iX Intrinsics Reference Manual > Chapter 4 Command Definitions

CATOPEN

» 

Technical documentation

Complete book in PDF
» Feedback

 » Table of Contents

 » Index

NM and CM callable.

Opens an application message catalog that was formatted with the GENCAT utility. CATOPEN returns a value that identifies the catalog and is used by CATREAD and CATCLOSE.

Syntax

     I32                 CA      U16A

   catindex:=CATOPEN(formaldesig,catstatus);

Functional Return

catindex

32-bit signed integer (assigned functional return)

An internal value recognized by the CATREAD and CATCLOSE intrinsics.

NOTE: The functional return is not a file number.

Parameters

formaldesig

character array (required)

Passes a string of ASCII characters that identify the catalog file to the system. This string must be terminated by an ASCII special character, it does not accept "/", ".", ":", or "!" as terminators.

formaldesig does not accept "/", ".", ":", or "!" as terminators.

catstatus

16-bit unsigned integer array (required)

Returns two elements; the first element is the error number, the second element is reserved and always returns 0. The possible values of the first element returned are:

ValueMeaning
0Successful
1Open failed on catalog file
2Could not access catalog file
3File specified not a GENCAT formatted catalog
100Internal message facility error

Operation Notes

The CATOPEN intrinsic may alter the condition code (CCODE).

Related Information

Intrinsics

CATCLOSE, CATREAD

Commands

None

Manuals

Message Catalogs Programmer's Guide (32650-90021)

Feedback to webmaster