CATOPEN

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:

VaIue

Meaning

0

Successful

1

Open failed on catalog file

2

Could not access catalog file

3

File specified not a GENCAT formatted catalog

100

Internal message facility error

Operation Notes

Related Information

Intrinsics

CATCLOSE, CATREAD

Manual

Message Catalogs Programmer's Guide