index_page_pa
status.i2.v = index_page_pa(page_name.i1a.r)
This function will translate an ASCII index page name to
a primary application (PA) number. For example, "M004" or "M4" or
"M 4" will return the value 52 because PA0052 is mapped to
index page M4. If no application is mapped, this function will
return a 0. A negative number indicates a user or network error.
This routine uses the CLIB miscellaneous ACNET standard error
code facility.
page_name ASCII index page name (PAGE_NAME_LEN characters)
This function returns status values as follows:
CLIB_IPP_BADCHAR bad character passed (The passed page
number does not contain a valid index page and
number character string.)
CLIB_IPP_NETERR network error (The communication with
Database to translate page number to PA failed.)
otherwise Primary Application (PA) number
This function requires the following include files:
clib_h, acnet_errors_h
Related functions:
pa_to_index_page_c
C/C++ usage:
static const char page_name[PAGE_NAME_LEN+1] = "M4 ";
short status;
status = index_page_pa(page_name);